THE CIP NETWORKS LIBRARY 
Volume 1 
Common Industrial Protocol (CIP™) 


Edition 3.3 


November, 2007 


ODVA & ControlNet International Ltd. 


The CIP Networks Library Volume 1: Common Industrial Protocol 


The CIP Networks Library 
Volume 1: Common Industrial Protocol (CIP™) 


Publication Number: PUBO0001 


Copyright © 2001 through 2007 Open DeviceNet Vendor Association, Inc. (ODVA). All rights 
reserved. For permissions to reproduce excerpts of this material, with appropriate attribution to 
the author(s), please contact ODVA at: 


Open DeviceNet Vendor Association, Inc. 
4220 Varsity Drive, Suite A, Ann Arbor, MI 48108-5006 USA 


TEL 1-734-975-8840 
FAX 1-734-922-0027 
EMAIL odva@odva.org 
WEB www.odva.org 


The right to make, use or sell product or system implementations described herein is granted 
only under separate license pursuant to a Terms of Usage Agreement or other agreement. 
Terms of Usage Agreements for individual CIP Networks are available, at standard charges, 
over the Internet at the following web sites: 


www.odva.org - Terms of Usage Agreements for CompoNet, DeviceNet, EtherNet/IP 
and CompoNet along with general information on CIP Networks and the association of 
ODVA 


www.controlnet.org - Terms of Usage Agreement for ControlNet along with general 
information on ControlNet and ControlNet International. 


Warranty Disclaimer Statement 


Because CIP Networks my be applied in many diverse situations and in conjunction with 
products and systems from multiple vendors, the user and those responsible for specifying CIP 
Networks must determine for themselves its suitability for the intended use. The Specifications 
are provided to you on an AS IS basis without warranty. NO WARRANTIES, EXPRESSED 
OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY WARRANTIES OF 
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE ARE BEING 
PROVIDED BY THE PUBLISHER, ODVA AND/OR CONTROLNET 
INTERNATIONAL. In no event shall the Publisher, ODVA and/or ControlNet International, 
their officers, directors, members, agents, licensors or affiliates be liable to you or any 
customer for lost profits, development expenses or any other direct, indirect incidental, special 
or consequential damages. 


ControlNet and ControlNet CONFORMANCE TESTED are trademarks of ControlNet 
International, Ltd. 


CIP, DeviceNet, DeviceNet CONFORMANCE TESTED, DeviceNet Safety, DeviceNet Safety 
CONFORMANCE TESTED, CompoNet and CompoNet CONFORMANCE TESTED, 
EtherNet/IP CONFORMANCE TESTED, EtherNet/IP Safety CONFORMANCE TESTED, 
and CIP Safety are trademarks of Open DeviceNet Vendor Association, Inc. 


EtherNet/IP is a trademark of ControlNet International under license by Open DeviceNet 
Vendor Association, Inc. 


All other trademarks referenced herein are property of their respective owners. 
Si 
Edition 3.3 
ODVA & ControlNet International Ltd. 


The CIP Networks Library Volume 1: Common Industrial Protocol 


The CIP Networks Library: Volume 1 


Common Industrial Protocol (CIP™) 


Revisions 


Preface 


Chapter 1 
Chapter 2 
Chapter 3 
Chapter 4 
Chapter 5 
Chapter 6 
Chapter 7 
Chapter 8 
Chapter 9 
Chapter 10 
Appendix A 
Appendix B 
Appendix C 
Appendix D 


Table of Contents 


- Summary of Changes in this Edition 


- Organization of CIP Networks Specifications 


- The Specification Enhancement Process 


- Introduction to the Common Industrial Protocol 
- Messaging Protocol 

- Communications Objects 

- CIP Object Model 

- Object Library 

- Device Profiles 

- Electronic Data Sheets 

- Physical Layer 

- Indicators and Middle Layers 
- Bridging and Routing 

- Explicit Messaging Services 
- Status Codes 

- Data Management 


- Engineering Units 


—iii- 
Edition 3.3 
ODVA & ControlNet International Ltd. 


The CIP Networks Library Volume 1: Common Industrial Protocol 


This page is intentionally left blank 


dos iv = 
Edition 3.3 
ODVA & ControlNet International Ltd. 


The CIP Networks Library Volume 1: Common Industrial Protocol 


Revisions 


The CIP Networks Library Volume 1: The Common Industrial Protocol Edition 3.3 contains 
the following changes from Edition 3.2. Please see the change bars on the pages noted here for 
specific modifications. Note: Some of the pages within the ranges noted may not contain any 


changes. 
Chapter Pages Reason for Change 
Add new extended status code and definition of scheduled network 
1-7.47 1-19 e Add new definition to table 
3-5.6.1 3-80 e Add new extended error code to Table 3-5.29 
Connection Path Enhancement 
3-5.5.1.10 3-63 e Modify three cells in Table 3-5.13 
C-1.5 C-14 e Add new hierarchy example 
AssemN Optional Size Field 
7-3.6.7.2 7-49 e Change Size from Required to Optional in Table 7-3.24 
7-3.6.7.2.3 7-50 e Add new paragraphs to describe when the size field is not present 
Allow 32-bit Logical Instances and Connection Points 
C-1.4.2 C-8 e Modify 32-bit logical address to indicate when allowed for use 
5-5 5-43 e Change Assembly Instance ID ranges in Table 5-5.2 
5-42 5-351 e Change reserved instance ID range in Table 5-42.1 
Assembly Object Member Service Support 
5-5.3 5-45 e Update Description of Service field for Get_Member & Set_Member services and 


make Set_Member service optional at the instance level. 
Drop ControlNet from the ControlNet Programmable Controller Profile 
6-7 6-21 e Remove ControlNet from the name in Table 6-7.1 
e Remove ControlNet from the name of the profile 


6-38 cae e Remove ControlNet and remove reference to scheduled originator from first paragraph 
6-33.1 6-180 e Modify caption of Table 6-33.1, remove Scheduling Object and remove ControlNet 
pont : from last paragraph 
6-33.2 6-18 e Remove ControlNet from first paragraph and remove Scheduling Object from Table 6- 
ee i ga.2 
Add Enhanced Mass Flow Controller Device Profile 
6-7 6-21 e Add new device to Device Type list 
6-42 6-292 e Add new section. 
Add UCD-4 Unicode Encoding Support to STRINGI 
C-2.1.2 C-18 e Add last line to Table C-2.3 
Connection Configuration Object Get_Attributes_All class level response data 
5-48.4 5-567 e Change Set_Attributes_All to N/A for class level 
5-48.4.1 5-567 e Add new text and table for Get All response — Class level 
5-48.4.2 5-569 e Add new text to first paragraph and changes to Table 5-48.12 
5-48.4.3 5-571,572 | e Add new text to first paragraph and changes to Table 5-48.15 
5-48.4.4 5-572 e Add new text to first paragraph and changes to Table 5-48.16 
5-48.4.5 5-572 e Add new text to first paragraph and changes to Table 5-48.17 
5-48.4.7 5-573 e Remove Error Table 
5-48.4.8 5-573 e Remove Error Table 
5-48.4.9 5-573 e Remove Error Table 
5-48.4.10 5-574 e Remove Error Table 
5-48.4.11 5-574 e Add new text to first paragraph and changes to Table 5-48.23 
5-48.4.12 5-574 e Add new text to first paragraph and changes to Table 5-48.26 
5-48.4.13 5-575,576 |e Add new text to first paragraph and changes to Table 5-48.28 
5-48.4.14 5-576 e Add new text to first paragraph and changes to Table 5-48.30 
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CompoNet Hooks 
3.7.3 3-89 e Change Port Type attribute access from Set to Get 
; e Add value 200 = CompoNet 
5-1 5-22 e Add 2 CompoNet objects to Table 5-5.1 
5-46.1 5-403 e Revise wording to allow use with any CIP network 
5-47.9 5-547 e Add CompoNet to Table 5-47.1 
5-47.13.1.10.1 5-552 e Add CompoNet to Table 5-47.5 
5-47.13.1.10.2 5-552 e Add CompoNet to Table 5-47.6 
6-2.1 6-13 e Numerous changes to Table 6-2.2 
6-7 6-20 e Add CompoNet Repeater to the Device Profile list in Table 6-7.1 
7-3.6.4 7-44 e Add CompoNet to the classification list 
7-3.6.10 7-70 e Add CompoNet to the Port Type list 
8-1 8-3 e Remove examples of CIP networks (last sentence) 
9-1 9-3 e Remove examples of CIP networks (last sentence) 
B-1 B-4 e Define status codes 23 and 24 (previously reserved) 
Get_All/Set_All Service Data Size Rules and Related Issues 
4-4 4-4 e Move definition of the term “default” from this section to 4-4.1 
4-4.1 4-5 e Add clarification for default value 
4-5.1 4-9 e Numerous changes 
4-5.2 4-9, 10 e Remove words in first paragraph and replace last paragraph 
4-9.2 4-19 e Numerous changes 
4-9.2.1.1 4-21 e Numerous changes to items 1 and 2 
4-9.2.1.2 4-22 e Removed subsections 4-9.2.1.2.2 (entirely) and 4-9.2.1.2.3 (partially) 
A-4.1 A-7 e Clarified wording of what is returned in the service reply 
A-4.1.1 A-7, 8 e Numerous changes 
A-4.2.1 A-9 e Numerous changes 
EF Protocol Safety Hooks 
5-48-2 5-562 e Add three new instance attributes (20-22) to Table 5-48.3 
5-48.4.1 5-569 e Removed names of Safety Parameters, corrected capitalization and added additional 
“3 safety parameters to end of Get_Attributes_All Response Data 
5-48.42 5-571 e Removed names of Safety Parameters, corrected capitalization and added additional 
mae safety parameters to end of Set_Attributes_All Response Data 
Modbus Integration Hooks 
3.7.3 3-89. 90 e Add new protocols to Attribute 1 and change TCP/IP to EtherNet/IP, change 
: : Description & Semantics of attribute 4 in Table 3-7.3 
5-1 5-22 e Add Modbus Object to list of defined objects 
5-2.2 5-24 e Add attribute 18 to Identity Object instance attribute list 
5-14.2.1.1 5-99 e Modify Bits 4 & 5 description, add bit 14 definition in Table 5-14.9 
6-7 6-21 e Add CIP Modbus device type to list of defined devices 
7-3.6.4 7-44 e Add ModbusSL & ModbusTCP to Device Classifications list 
7-3.6.5 7-45 e Changed Data Type of Scaling Offset and added footnote, both in Table 7-3.22 
e Changed Port name to Conditional and added footnote, both in Table 7-3.38 
7-3.6.10 7-69 Added ModbusSL & ModbusTCP to port types list 
Modified description of Port Name field 
B-1 B-4 e Define General Status Code 2B 
Typographical errors/corrections 
3-5.5.1.10.1 3-65 e Remove extra “the” from the first sentence 
3-6.1.4 3-83 e Corrected caption of Table 3-6.1 to say “32-bit...” 
5-12.5.1.2 5-88 e Changed “Discrete” to “Analog” 
e Corrected reference to a table in Chapter 3. Table was no longer at that reference due to 
5-48.2.2.1 5-563 revisions to the chapter. Changed reference to something more distinct and less likely 
to change over time. 
5-48.2.2.4 5-564 e Removed extra word (“a”) from the second sentence of the second paragraph 
C-all 5 e Replaced all figure/table captions and references 
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Preface 
Organization of the CIP Networks Specifications 


Today, four networks - DeviceNet™, ControlNet™, EtherNet/IP™ and CompoNet™ - use the 
Common Industrial Protocol (CIP) for the upper layers of their network protocol. For this 
reason, the associations that manage these networks - ODVA and ControlNet International - 
have mutually agreed to manage and distribute the specifications for CIP Networks in a 
common structure to help ensure consistency and accuracy in the management of these 
specifications. 


The following diagram illustrates the organization of the library of CIP Network specifications. 
In addition to CIP Networks, CIP Safety™ consists of the extensions to CIP for functional 
safety. 
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This common structure presents CIP in one volume with a separate volume for each network 
adaptation of CIP. The specifications for the CIP Networks are two-volume sets, paired as 
shown below. 


The EtherNet/IP specification consists of: 
Volume 1: Common Industrial Protocol (CIP™) 
Volume 2: EtherNet/IP Adaptation of CIP 

The DeviceNet specification consists of: 
Volume 1: Common Industrial Protocol (CIP™) 
Volume 3: DeviceNet Adaptation of CIP 

The ControlNet specification consists of: 
Volume 1: Common Industrial Protocol (CIP™) 
Volume 4: ControlNet Adaptation of CIP 

The CompoNet specification consists of: 
Volume 1: Common Industrial Protocol (CIP™) 

Volume 6: CompoNet Adaptation of CIP 

The specification for CIP Safety™ is distributed in a single volume: 
Volume 5: CIP Safety 


The specification for integrating Modbus Devices is distributed in a single volume: 


Volume 7: Integration of Modbus Devices into the CIP Architecture 


Specification Enhancement Process 


The specifications for CIP Networks are continually being enhanced to meet the increasing 
needs of users for features and functionality. ODVA and ControlNet International have also 
agreed to operate using a common Specification Enhancement Process in order to ensure open 
and stable specifications for all CIP Networks. This process is on going throughout the year for 
each CIP Network Specification as shown in the figure below. New editions of each CIP 
Network specification are published on a periodic basis. 
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Chapter 1: Introduction to CIP 


Volume 1: Common Industrial Protocol Specification, Chapter 1: Introduction to CIP 
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1-1 Introduction 


The Common Industrial Protocol (CIP) is a peer to peer object oriented protocol that provides 
connections between industrial devices (sensors, actuators) and higher-level devices 
(controllers). CIP is physical media and data link layer independent. See Figure 1-1.1. 


Figure 1-1.1 Example CIP Communication Link 


Controller 


CIP Network 


Pushbutton 
Cluster 


eo | 
oo 


Bar Code 
Scanner 


Device Configuration Input/Output 
Devices 


Controller 


CIP has two primary purposes: 


e Transport of control-oriented data associated with I/O devices 
e Transport of other information that is related to the system being controlled, such as 
configuration parameters and diagnostics. 
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1-2 


Object Modeling 


CIP makes use of abstract object modeling to describe: 


e The suite of communication services available 


e The externally visible behavior of a CIP node 
e A common means by which information within CIP products is accessed and exchanged 


A CIP node is modeled as a collection of Objects. An Object provides an abstract 
representation of a particular component within a product. The realization of this abstract 
object model within a product is implementation dependent. In other words, a product 
internally maps this object model in a fashion specific to its implementation. 


A Class is a set of Objects that all represent the same kind of system component. An Object 
Instance is the actual representation of a particular Object within a Class. Each Instance of a 
Class has the same set of attributes, but has its own particular set of attribute values. As Figure 
1-2.1 illustrates, multiple Object Instances within a particular Class can reside in a CIP node. 


Figure 1-2.1 A Class of Objects 
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An Object Instance and/or an Object Class has Attributes, provides Services, and implements a 
Behavior. 


Attributes are characteristics of an Object and/or an Object Class. Typically, Attributes provide 
status information or govern the operation of an Object. Services are invoked to trigger the 
Object/Class to perform a task. The Behavior of an Object indicates how it responds to 
particular events. For example, a person can be abstractly viewed as an Instance within the 
Class Human. Generally speaking, all humans have the same set of attributes: age, gender, etc., 
yet, because the values of each attribute vary, each of us looks/behaves in a distinct fashion. 


Table 1-2.1 Object Model Terminology Examples 


Class Attributes Attribute Values 


Human Female 
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The following Object Modeling related terms are used when describing CIP services and 
protocol. 


e Object — An abstract representation of a particular component within a product. 

e Class — A set of objects that all represent the same kind of system component. A class is a 
generalization of an object. All objects in a class are identical in form and behavior, but 
may contain different attribute values. 

e Instance — A specific and real (physical) occurrence of an object. For example: New 
Zealand is an instance of the object class Country. The terms Object, Instance, and Object 
Instance all refer to a specific Instance. 

e Attribute — A description of an externally visible characteristic or feature of an object. 
Typically, attributes provide status information or govern the operation of an Object. For 
example: the ASCII name of an object; and the repetition rate of a cyclic object. 

e Instantiate - To create an instance of an object with all instance attributes initialized to 
zero unless default values are specified in the object definition. 

e Behavior — A specification of how an object acts. Actions result from different events the 
object detects, such as receiving service requests, detecting internal faults or elapsing 
timers. 

e Service — A function supported by an object and/or object class. CIP defines a set of 
common services and provides for the definition of Object Class and/or Vendor Specific 
services. CIP common services are those whose parameters and required behaviors are 
defined in Appendix A. 

e Communication Objects - A reference to the Object Classes that manage and provide the 
run-time exchange of implicit (I/O) and explicit messages. 

e Application Objects - A reference to multiple Object Classes that implement 
product-specific features. 
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1-2.1 Object Addressing 


The information in this section provides a common basis for logically addressing separate 
physical components across CIP. The following list describes the information that is used to 
address an Object from a CIP network: 


e Media Access Control Identifier (MAC ID) - An identification value assigned to each 
node on the CIP network. This value distinguishes a node among all other nodes on the 
same link. The MAC ID format is network specific. 


Figure 1-2.2 MAC ID Example 
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e Class Identifier (Class ID) - An integer identification value assigned to each Object Class 
accessible from the network. 


Figure 1-2.3 Class ID Example 
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e Instance Identifier (Instance ID) - An integer identification value assigned to an Object 
Instance that identifies it among all Instances of the same Class. This integer is unique 
within the MAC ID:Class in which it resides. 


Figure 1-2.4 Instance Identifier Example 
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It is also possible to address the Class itself versus a specific Object Instance within the Class. 
This is accomplished by utilizing the Instance ID value zero (0). CIP reserves the Instance 
ID value zero (0) to indicate a reference to the Class versus a specific Instance within the 
Class. 


Figure 1-2.5 Instance #0 Example 
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e Attribute Identifier (Attribute ID) - An integer identification value assigned to a Class 
and/or Instance Attribute. 


Figure 1-2.6 Attribute ID Example 


MAC ID #4: Object Class #5: Instance #2: Attribute #1 
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e Service Code - An integer identification value which denotes a particular Object Instance 
and/or Object Class function. 


Figure 1-2.7 Service Code Example 
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1-2.2 Address Ranges 


This section presents CIP defined ranges for the Object Addressing information presented in 
the previous section. The following terms are used when defining the ranges: 


e Open - A range of values whose meaning is defined by ODVA/CI and are common to all 
CIP participants. 

e Vendor Specific - A range of values specific to the vendor of a device. These are used by 
vendors to extend their devices beyond the available Open options. A vendor internally 
manages the use of values within this range. 


e Object Class Specific - A range of values whose meaning is defined by an Object Class. 
This range applies to Service Code definitions. 


Table 1-2.2 defines the ranges applicable to Class ID values. 


Table 1-2.2 Class ID Ranges 


Range Meaning 
00 - 63hex CIP Common 
64hex - C7hex Vendor Specific 
C8hex - EFhex Reserved by ODVA/CI for future use 
FOhex - 2FFhex CIP Common 
300hex - 4FFhex | Vendor Specific 
500hex - FFFFhex | Reserved by ODVA/CI for future use 


Table 1-2.3 defines the ranges applicable to Service Code values. 


Table 1-2.3 Service Code Ranges 


Range Meaning 
00 - 31hex CIP Common. These are referred to as CIP Common Services. These are 
defined in Appendix A, Explicit Messaging Services. 
32hex - 4Ahex Vendor Specific 
4Bhex - S3hex Object Class Specific 
64hex - 7Fhex Reserved by ODVA/CI for future use 
80hex - FFhex Invalid/Not used 


Table 1-2.4 defines the ranges applicable to Attribute ID values. 


Table 1-2.4 Attribute ID Ranges 


Range Meaning 
00 - 63hex CIP Common 
64hex - C7hex Vendor Specific 
C8hex - FFhex Reserved by ODVA/CI for future use 
100hex — 2FFhex | CIP Common 
300hex —4FFhex | Vendor Specific 
500phex — 8FFhex | CIP Common 
900hex - CFFhex | Vendor Specific 
D00pex - FFFFhex | Reserved by ODVA/CI for future use 
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1-3 Network Overview 


CIP defines a connection-based scheme to facilitate all application communications. A CIP 
connection provides a communication path between multiple end-points. The end-points of a 
connection are applications that need to share data. Transmissions associated with a particular 
connection are assigned an identification value when a connection is established. This 
identification value is called the Connection ID (CID). 


Connection Objects model the communication characteristics of a particular 
Application-to-Application(s) relationship. The term end-point refers to one of the 
communicating entities involved in a connection. 


CIP’s connection-based scheme defines a dynamic means by which the following two types of 
connections can be established: 


e I/O Connections - Provide dedicated, special-purpose communication paths between a 
producing application and one or more consuming applications for the purpose of moving 
application-specific data. This is often referred to as implicit messaging 

e Explicit Messaging Connections - Provide generic, multi-purpose communication paths 
between two devices. These connections often are referred to as just Messaging 
Connections. Explicit Messages provide the typical request/response-oriented network 
communications. 
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1-3.1 I/O Connections 


As previously stated, I/O Connections provide special-purpose communication paths between a 
producing application and one or more consuming applications. Application-specific I/O data 
moves across an I/O Connection. 


I/O Messages are exchanged across I/O connections. An I/O Message consists of a Connection 
ID and optional associated I/O data. The meaning of the data within an I/O Message is implied 

by the associated Connection ID. The connection end-points are assumed to have knowledge of 
the intended use or meaning of the I/O Message. 


Figure 1-3.1 CIP I/O Connection 
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This document does not define any particular use for I/O Messaging. There are a wide 
variety of functions that can be accomplished using I/O Messaging. Either by virtue of the 
particular type of product transmitting an I/O Message, or based upon configuration performed 
using Explicit Messaging, the meaning and/or intended use of all I/O Messages can be made 
known to the system. See Chapter 6 Device Profiles for I/O message formats defined for 
common device types. 
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1-3.2 Explicit Messaging Connections 


Explicit Messaging Connections provide generic, multi-purpose communication paths between 
two devices. Explicit Messages are exchanged across Explicit Messaging Connections. 
Explicit Messages are used to command the performance of a particular task and to report the 
results of performing the task. Explicit Messaging provides the means by which typical 
request/response oriented functions are performed (e.g. module configuration). 


CIP defines an Explicit Messaging protocol that states the meaning of the message. An Explicit 
Message consists of a Connection ID and associated messaging protocol information. 


Figure 1-3.2 CIP Explicit Messaging Connection 
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1-4 CIP Object Model 


Figure 1-4.1 illustrates the abstract object model of a CIP product. Included are the following 
components: 


e Unconnected Message Manager (UCMM) - Processes CIP Unconnected Explicit 
messages. 

e Connection Object Class- Allocates and manages internal resources associated with both 
I/O and Explicit Messaging connections. 

e Connection Object Instance- Manages the communication-specific aspects associated 
with a particular application-to-application network relationship. 

e Connection Manager — An object class, required in some CIP network nodes, used to 
control certain aspects of Connection Object instances within the node. 

e Network-Specific Link Object - Provides the configuration and status of a physical CIP 
network connection (eg. DeviceNet and ControlNet objects). 

e Message Router - Distributes Explicit Request Messages to the appropriate handler object. 

e Application Objects - Implement the intended purpose of the product. 


Figure 1-4.1 CIP Device Object Model 
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1-5 System Structure 


1-5.1 Topology 


The system structure uses the following physical organization. 


e System = { Domain(s) } 
e System contains one or more domains. 

e Domain = { Network(s) } 

e A domain is a collection of one or more networks. Networks must be unique within a 
domain. A domain may contain a variety of network types. 

Network = { Subnet(s) } 

e A network is a collection of one or more subnets, where each node’s MAC ID is unique 
on the network. 

Subnet = { Nodes(s) } 

e A subnet is a collection of nodes using a common protocol and shared media access 
arbitration. i.e. subnet may have multiple physical segments and contain repeaters. 

Segment = { Nodes(s) } 

e A segment is a collection of nodes connected to a single uninterrupted section of 
physical media. 

Node = { Object(s) } 

e Anode isa collection of objects that communicate over a subnet, and arbitrates using a 
single MAC ID. A physical device may contain one or more nodes. 


Figure 1-5.1 System Structure - Topology 


Non-CIP Network 


—1-14- 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 1: Introduction to CIP 


e Segment Repeater between segments 


e Segments participate in the same media arbitration 


e Ke Subnet Bridge between subnets 


e Duplicate MAC ID check passes through 
e MAC ID’s on one subnet shall not be duplicated on the other subnet 
e Subnets may operate at different baud rates 


e AQ Network Router between similar networks 
e Both networks are CIP-based 
° KS Gateway between dissimilar networks 


@ One network is CIP-based, the other is not 


1-5.2 Logical Structure 


The system structure uses the following logical elements. 


e Cluster = { Node(s) } 


e A cluster is a collection of nodes that are logically connected. A node may belong to 
one or more clusters. A cluster may span subnets, networks or domains. 


Figure 1-5.2 Clusters 
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Cluster A - Master/Slave Point-to-point Communication (i.e. Poll/Cyclic/COS) 


e A Master and it’s Slaves are a cluster 
e A Master may also be a slave to another Master 


Cluster B - Multicast Master/Slave Communication (i.e. Strobe) 


e A Master and its Slaves are a cluster 
e A Master may also participate with a peer in any cluster 


Cluster C - Peer-to-peer Communication (point-to-point or multicast) 


e Nodes participating in a particular peer-to-peer relationship are a cluster 
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CIP Specification Structure 


The CIP Networks Library is the definition of the application and user layers for a number of 
different network adaptations. The figure below shows the relationship between the 
specifications of this document and those of the CIP-based networks. 


Figure 1-6.1 CIP Architecture and Related Specifications 
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1-7 


Definitions 


For the purposes of this standard, the following definitions apply. 


Term Definition 

1-7.1 actual packet The measure of how frequently a specific connection produces its data. 

interval (API) 

1-7.2 allocate To take a resource from a common area and assign that resource for the exclusive use of a 
specific entity. 

1-7.3. application Function or data structure for which data is consumed or produced. 

1-7.4 application Multiple object classes that manage and provide the run-time exchange of messages 

objects across the network and within the network device. 

1-7.5 attribute A description of an externally visible characteristic or feature of an object. The attributes 
of an object contain information about variable portions of an object. Typically, they 
provide status information or govern the operation of an object. Attributes may also 
affect the behavior of an object. Attributes are divided into class attributes and instance 
attributes. 

1-7.6 behavior Indication of how the object responds to particular events. Its description includes the 
relationship between attribute values and services. 

1-7.7 _ big endian A format for storage or transmission of binary data in which the most significant bit (or 
byte) comes first. The term comes from "Gulliver's Travels" by Jonathan Swift. The 
Lilliputians, being very small, had correspondingly small political problems. The Big- 
Endian and Little-Endian parties debated over whether soft-boiled eggs should be opened 
at the big end or the little end. See also: little-endian. [Source: RFC1392] 

1-7.8 bit A unit of information consisting of a 1 or a0. This is the smallest data unit that can be 
transmitted. 

1-7.9 byte See octet. 

1-7.10 class A set of objects all of which represent a similar system component. A class is a 
generalization of the object, a template for defining variables and methods. All objects in 
a class are identical in form and behavior, but they may contain different attribute values. 

1-7.11 class specific A service defined by a particular object class to perform a required function that is not 

service performed by a common service. A class specific object is unique to the object class that 
defines it. 

1-7.12 client (1) An object that uses the services of another (server) object to perform a task. 

(2) An initiator of a message to which a server reacts. 
1-7.13 communication Components that manage and provide run-time exchange of messages across the network 
objects such as the Connection Manager object, the unconnected message manager (UCMM), and 
the Message Router object. 

1-7.14 connection A logical binding between two application objects. These application objects may be the 
same or different devices. 

1-7.15 connection ID Identifier assigned to a transmission that is associated with a particular connection 

(CID) between producers and consumers that identifies a specific piece of application 
information. 

1-7.16 connection path Is made up of a byte stream that defines the application object to which a connection 
instance applies. 

1-7.17 consume The act of receiving data from a producer. 

1-7.18 consumer A node that is receiving data from a producer. 

1-7.19 consuming The application that consumes data. 

application 
1-7.20 cyclic Term used to describe events that repeat in a regular and repetitive manner. 
1-7.21 device A physical hardware connection to the link. A device may contain more than one node. 
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Term 


Definition 


1-7.22 device profile A collection of device-dependent information and functionality providing consistency 
between similar devices of the same device type. 

1-7.23 end node A producing or consuming node. 

1-7.24 end point One of the communicating entities involved in a connection. 

1-7.25 error A discrepancy between a computed, observed or measured value or condition and the 
specified or theoretically correct value or condition. 

1-7.26 instance The actual physical presentation of an object within a class. Identifies one of many 
objects within the same object class. 

1-7.27 instantiated An object that has been created in a device. 

1-7.28 library element A derived or standard data type, function, function block, program or resource in 
IEC 1131 - programmable controllers. 

1-7.29 link Collection of nodes with unique MAC IDs. Segments connected by repeaters make up a 
link; links connected by routers make up a network. 

1-7.30 little endian Describes a model of memory organization that stores the least significant byte at the 
lowest address. On the network medium, the lowest order byte is transferred first. The 
native CIP data types are sent in little endian order. See appendix C of the CIP Common 
specification for a detailed description of this encoding. 

1-7.31 Message Router The object within a node that distributes messaging requests to the appropriate application 
objects. 

1-7.32 multicast A packet with a special destination address, which multiple nodes on the network may be 
willing to receive. [Source: RFC1392] 

1-7.33 multicast A connection from one node to many. Multicast connections allow a single producer to 

connection be received by many consumer nodes. 

1-7.34 network A series of nodes connected by some type of communication medium. The connection 
paths between any pair of nodes can include repeaters, routers and gateways. 

1-7.35 network address An identification value assigned to each node on the CIP network. This value 

or node address distinguishes a node among all other nodes on the same link. The format is network 
specific. 

1-7.36 node A connection to a link that requires a single MAC ID. 

1-7.37 object (1) An abstract representation of a particular component within a product. Objects can be 
composed of any or all of the following components: 

a) data (information which changes with time); 

b) configuration (parameters for behavior); 

c) methods (things that can be done using data and configuration). 
(2) A collection of related data (in the form of variables) and methods (procedures) for 
operating on that data that have clearly defined interface and behavior. 

1-7.38 object specific A service defined by a particular object class to perform a required function that is not 

service performed by a common service. An object specific service is unique to the object class 
that defines it. 

1-7.39 octet An octet is 8 bits that indicates no particular data type. 

1-7.40 _ originator The client responsible for establishing a connection path to the target. 

1-7.41 point-to-point A connection that exists between two nodes only. Connections can be either point-to- 

connection point or multicast. 

1-7.42 port A CIP port is the abstraction for a physical network connection to a CIP device. A CIP 
device has one port for each network connection. Note: network specific definitions may 
include additional definitions of this term within the context of the network. 

1-7.43 produce Act of sending data to a consumer. 
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Term Definition 
1-7.44 producer A node that is responsible for transmitting data. 
1-7.45 redundant media | A system using more than one medium to help prevent communication failures. 
1-7.46 requested packet | The measure of how frequently the originating application requires the transmission of 
interval (RPI) data from the target application. 
1-7.47_ scheduled A network which utilizes a time-based scheduling mechanism that provides network 
network devices with deterministic and predictable access to the medium while preventing 
network collisions. 
1-7.48 serial number A unique 32-bit integer assigned by each manufacturer to every device. The number need | 
only be unique with respect to the manufacturer. 
1-7.49 server An object that provides services to another (client) object. | 
1-7.50 service Operation or function that an object performs upon request from another object. | 
1-7.51 target The end-node to which a connection is established. | 
1-7.52 tool An executable software program that interacts with the user to perform some function. | 
1-7.53 unconnected The component within a node that transmits and receives unconnected explicit messages | 
message manager | and sends them directly to the Message Router object. 
(UCMM) 
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1-8 Abbreviations 


For the purposes of this standard, the following abbreviations apply. 


Abbreviation Meaning 
1-8.1 API Actual Packet Interval 
1-8.2. ASCII American Standard Code for Information Interchange 
1-8.3. ASN.1 Abstract Syntax Notation 
1-8.4 Cl ControlNet International, Ltd. 
1-8.5 CIP The Common Industrial Protocol defined by the CIP Common Specification. CIP includes 
both connected and unconnected messaging. 
1-8.6 CID Connection Identifier 
1-8.7. DLL Data Link Layer 
1-8.8 EPR Expected Packet Rate 
1-8.9 ISO International Standards Organization 
1-8.10 MACID Media Access Control Identifier 
1-8.11 PDU Protocol Data Unit 
1-8.12 ODVA Open DeviceNet Vendor Association 
1-8.13 O->T Originator to Target (used to describe packets that are sent from the originator to the target) 
1-8.14 OSI Open Systems Interconnection (see ISO 7498) 
1-8.15 RPI Requested Packet Interval 
1-8.16 SDU Service Data Unit 
1-8.17 SEM State Event Matrix 
1-8.18 SEMI Semiconductor Equipment Materials International 
1-8.19 STD State Transition Diagram, used to describe object behavior 
1-8.20 T->O Target to Originator (used to describe packets that are sent from the target to the originator) 
1-8.21 UCMM Unconnected Message Manager 
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2-1 Introduction 


CIP is layered on top of a connection-based network. A CIP connection provides a path 
between multiple applications. When a connection is established, the transmissions associated 
with that connection are assigned a Connection ID (CID). If the connection involves a 
bi-directional exchange, then two Connection ID values are assigned. See Figure 2-1.1. 


Figure 2-1.1 Connections and Connection IDs 


Connection ID = 1 
Application Connection Data = a messag Connection Application 
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Connection ID = 2 
Data = a message 


The definition and format of the connection ID is network dependent. For example, the 
connection ID for CIP connections over DeviceNet is based on the CAN Identifier Field. 
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2-2 Connection Establishment Overview 


This section presents an overview of dynamically establishing both Explicit Messaging and I/O 
Connections. 


2-2.1 Explicit Messaging and the UCMM 


The Unconnected Message Manager (UCMM) is responsible for processing Unconnected 
Explicit Requests and Responses. This includes establishing both Explicit Messaging and I/O 
connections. The underlying network defines how the UCMM is accessed and may limit the 
messaging which can occur across the UCMM. 


When using the UCMM to establish an explicit messaging connection, the target application 
object is the Message Router object (Class Code 2). 


Figure 2-2.1 illustrates the steps involved in establishing a Messaging Connection. 
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Figure 2-2.1 Establishing an Explicit Messaging Connection 
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Explicit Messaging Connections are unconditionally point-to-point. Point-to-point connections 
exist between two devices ONLY. The device that requests that the connection be opened (the 
client) is one end-point of the connection, and the module that receives and responds to the 
request (the server) is the other end-point. See Figure 2-2.2. 


Figure 2-2.2 Point-to-Point Nature of Explicit Messaging Connections 
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2-2.2 I/O Connections 


The CIP Network definition allows the establishment of a variety of I/O connections. This 
specification does not dictate any rules associated with who may perform Connection 
configuration. For example, a tool could interface with two separate devices and create an I/O 
Connection between them. See Figure 2-2.3. 


Figure 2-2.3 Tool Interface with Devices to Create Connection 
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The tool uses various Explicit Messaging Services to create and configure the I/O Connection 
Objects within the end points. 


I/O connections can be either point-to-point or multicast. Multicast connections allow a single 
transmission to be heard by many nodes. See Figure 2-2.4. 
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Figure 2-2.4 Point-to-Point or Multicast Nature of I/O Connections 
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2-3 Client and Server Connection Endpoints 


The terms Client and Server are used throughout this document when discussing the behavior 
associated with a connection end-point. A Client end-point and Server end-point(s) are 
associated with both Explicit Messaging and I/O Connections. The Client is the module that 
originates a transmission, and the Server is the module that reacts to that transmission. The 
Server’s reaction may cause it to return a message to the Client. 


Figure 2-3.1 Illustration of Client/Server Message Flow 
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2-4 Message Router Request/Response Formats 
CIP defines a standard data format for delivering data to and from the Message Router object. 
This data format is used in various places within CIP including the Unconnected Send service 
of the Connection Manager object and the UCMM data structures of most of the CIP networks. 


The Message Router Request Format is defined in Table 2-4.1. 


Table 2-4.1 Message Router Request Format 


Parameter Name Data Type Description 
Service USINT Service code of the request. 

Request_Path_Size | USINT The number of 16 bit words in the Request_Path field (next element). 
Request_Path Padded This is an array of bytes whose contents convey the path of the request 
EPATH (Class ID, Instance ID, etc.) for this transaction. 

Request_Data Array of Service specific data to be delivered in the Explicit Messaging Request. 
octet If no additional data is to be sent with the Explicit Messaging Request, 
then this array will be empty. 


The Message Router Response Format is defined in Table 2-4.2. 


Table 2-4.2 Message Router Response Format 


Parameter Name Data Type Description 

Reply Service USINT Reply service code. 
Reserved octet Shall be zero. 
General Status USINT One of the General Status codes listed in Appendix B (Status Codes). 
Size of Additional USINT Number of 16 bit words in Additional Status array. 
Status 
Additional Status Array of Additional status. 

WORD 
Response Data Array of Response data from request or additional error data if General Status 

octet indicated an error. 
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3-1.1 


Introduction 


The CIP Communication Objects manage and provide the run-time exchange of messages. The 
Services, Attributes, and Behaviors associated with the Communication Objects are detailed in 
this Chapter. Part of an object definition involves assigning a Data Type to an attribute. See 
Appendix C for a detailed description of CIP Data Types and Data Management. 


Important: It is not the intent of the following sections to specify any particular internal 
implementation. 


The Communication Object Classes are defined by describing: 


e Object Class Attributes 

e Object Class Services 

e Object Instance Attributes 
e Object Instance Services 
e Object Instance Behavior 


Each CIP connection is represented by a Connection Object (Class code 0x05). The creation of 
this communication object resource can be done in one of two ways. Each subnet type defines 
which method shall be used. The two methods are: 


e Use of the Create service (Service code 0x08) for the Connection Object 
e Use of the Forward Open service for the Connection Manager Object 


Subnet types may define other methods of creating this communication object resource. An 
example of this is DeviceNet’s Allocate_Master/Slave_Connection_Set service. See the 
appropriate specification volume for details of subnet type-specific methods. 


Creating Connections Through the Connection Object 


When the subnet defines that connections are created through the Connection Object, a CIP 
device shall support the Create service for this class. The Create service instantiates a 
Connection Instance with attribute values defaulted as defined by the class. The connection 
instance is configured through individual access to each Connection instance attribute. A 
separate service request (Apply_Attributes, Service code O0x0D) is needed to transition the 
connection to the Established state. 


Creating Connections Through the Connection Manager Object 


When the subnet defines that connections are created through the Connection Manager Object, 
a CIP device shall support the Forward Open service of this class. When successful, the 
Connection Manager instantiates an instance of the Connection class. This connection instance 
is configured with the values sent in the Forward Open service and is transitioned to the 
established state. This single CIP service request is modeled internally as a single Connection 
Class service request (using the Create service) and several internal service requests (using the 
Set_Attribute_Single and Apply_Attributes services). A device supporting connection creation 
through the Connection Manager may or may not provide external visibility to the Connection 
Class instances. 
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3-2 


3-2.1 


3-2.2 


3-2.3 


3-2.3.1 


3-2.3.2 


3-2.4 


Link Producer Object Class Definition 
The Link Producer Object is the component responsible for the low-level transmission of data. 


Important: NO externally visible interface to the Link Producer Class across Explicit 
Messaging Connections exists. All services/attributes noted in the following sections describe 
internal behavior. These services/attributes are accessed via attributes and services of the 
Connection Object. 


Link Producer Object Class Attributes 


There are no Link Producer Class Attributes. 


Link Producer Object Class Services 


The services supported by the Link Producer Class are listed below. 


e Create - Used internally to instantiate a Link Producer Object 
e Delete - Used internally to deletes a Link Producer Object 


Link Producer Object Instance Attributes 


The following list describes the Link Producer Instance attributes. 


state, USINT data type 


This contains the current state of the Link Producer instance. Possible states include the 
following: 


Table 3-2.1 Link Producer States 


State Name Description 


Non-existent The Link Producer has yet to be instantiated 


Running The Link Producer has been instantiated and is waiting to be told to 


transmit via the invocation of its Send service. 


connection_id 


The value placed within the message frame when this Link Producer is triggered to send. The 
placement and format of this value within the message frame is subnet type-specific. The 
Connection Object using this Link Producer internally initializes this attribute with the value in 
its produced_connection_id attribute. See section 3-4.4, Connection Instance Attributes for a 
definition of the produced_connection_id attributes. 


Link Producer Object Instance Services 


The services supported by a Link Producer Object Instance are listed below. 


e Send - Used internally to tell the Link Producer to transmit data onto the subnet. 
e Get_Attribute - Used internally to read a Link Producer Object attribute 
e Set_Attribute - Used internally to modify a Link Producer Object attribute 
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3-2.5 Link Producer Instance Behavior 


Figure 3-2.1 and Table 3-3.2 illustrate the Link Producer’s Instance behavior. 


Figure 3-2.1 Link Producer in Object State Transition 


Non-Existent 


Running 


Table 3-2.2 State/Event Matrix: Link Producer 


Event State 


Class Create invoked internally Class instantiates Link Producer __| Not applicable 
Object. Link Producer enters the 
Running state. 


Non-Existent Running 


Class Delete invoked internally Error: Instance Not Present Release all associated instance 
resources. Transition to the 
Non-existent state. 


Send invoked internally Error: Instance Not Present Transmit the data 


Set_Attribute invoked internally Error: Instance Not Present Modify the attribute 


Get_Attribute invoked internally Error: Instance Not Present Return the attribute value 
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3-3.1 


3-3.2 


3-3.3 


3-3.3.1 


3-3.3.2 


3-3.4 


Link Consumer Object Class Definition 


The Link Consumer Object is the component responsible for the low-level reception of 
messages. 


Important: NO externally visible interface to the Link Consumer Class across Explicit 
Messaging Connections exists. All services/attributes noted in the following sections describe 
internal behavior. These services/attributes are accessed via attributes and services of the 
Connection Object. 


Link Consumer Object Class Attributes 


There are no Link Consumer Class Attributes. 


Link Consumer Class Services 


The services supported by the Link Consumer Class are listed below. 


e Create - Used internally to instantiate a Link Consumer Object 
e Delete - Used internally to deletes a Link Consumer Object 


Link Consumer Instance Attributes 


The following list describes the Link Consumer Instance attributes. 


state, USINT data type 


This contains the current state of the consumer instance. Possible states include: 


Table 3-3.1 Link Consumer States 


State Name Description 


Non-existent The Link Consumer has yet to be instantiated. 


Running The Link Consumer has been instantiated and is waiting to receive a message. 


connection_id 


This attribute holds the Connection ID value in the message frame that denotes the message to 
be received by this consumer. The placement and format of this value within the message 
frame is subnet type-specific. The Connection Object utilizing this Link Consumer internally 
initializes this attribute with the value in its consumed_connection_id attribute. See section 3- 
4.4, Connection Instance Attributes for a definition of the consumed_connection_id attributes. 


Link Consumer Instance Services 


The services supported by a Link Consumer Object Instance are listed below. 


e Get_Attribute - Used internally to read a Link Consumer Object attribute 
e Set_Attribute - Used internally to modify a Link Consumer Object attribute 
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3-3.5 Link Consumer Instance Behavior 


Figure 3-3.1 and Table 3-3.2 illustrate the Link Consumer’s Instance behavior. 


Figure 3-3.1 Link Consumer Object State Transition Diagram 


Non-Existent 


Data 
Received 


Table 3-3.2 State/Event Matrix: Link Consumer 


Event State 
Class Create invoked internally Class instantiates Link Consumer | Not applicable 


Object. Link Consumer enters the 
Running state. 


Class Delete invoked internally Error: Instance Not Present Release all associated instance 
resources. Transition to the 
Non-existent state. 


Data received Not applicable Deliver data to the associated 
Connection Object by invoking its 
Receive_Data() service 


Set_Attribute invoked internally Error: Instance Not Present Modify the attribute 
Get_Attribute invoked internally Error: Instance Not Present Return the attribute value 
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3-4.1 


Connection Object Class Definition 
Class Code: 05 hex 


The Connection Class allocates and manages the internal resources associated with both I/O 
and Explicit Messaging Connections. The specific instance generated by the Connection Class 
is referred to as a Connection Instance or a Connection Object. 


Unless otherwise noted, all services/attributes noted in the following sections are accessible 
using Explicit Messaging. 


A Connection Object within a particular module actually represents one of the end-points of a 
Connection. It is possible for one of the Connection end-points to be configured and “active” 
(e.g. transmitting) without the other end-point(s) being present. Connection Objects are used to 
model the communication specific characteristics of a particular Application-to-Application(s) 
relationship. 


A specific Connection Object Instance manages the communication-specific aspects related to 
an end-point. A CIP Connection Object uses the services provided by a Link Producer and/or 


Link Consumer to perform low-level data transmission and reception functions. 


Figure 3-4.1 Connection Object & Link Producer/Consumer Relationship 


7 


/ 
/ 
! 
Application ! 
| 
\ 
\ 
\ 


Connection Object Class Attributes 


Link 


produce: transmission 


reception 


\ 7 


The Connection Class attributes are defined below in Table 3-4.1. 


Table 3-4.1 Connection Class Attributes 


Conditional ? Connection 
Request See CIP Safety Specification 
Error Count 
— 7 (Volume 5, Chapter 5) 
Conditional Safety 
Connection 
Counters 


1 These attributes are not allowed if the device is not a safety device. If the device is a safety device, see 
Volume 5. 
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3-4.2 Connection Object Class Services 


The Connection Class supports the following CIP Common Services: 


Table 3-4.2 Connection Class Services 


Service Need In Service Name Service Description 
Code Implementation 


O8hex Optional Used to instantiate a Connection Object 


O09hex Optional Delete Used to delete all Connection Objects (independent of state) and 
to release all associated resources. When the Delete service is 
sent to the Connection Class (Instance ID set to zero (0)) versus a 
specific Connection Object Instance, then ALL Instances are 


deleted. 


O5hex Optional Reset Used to reset all resettable Connection Objects. The conditions 
under which a Connection is resettable are listed in the State Event 
Matrix in section 3-4.7 


11hex Optional Find_Next_ Used to search for Instance IDs associated with existing 
Object_Instance | Connection Objects. The Connection Class returns the Instance 
ID associated with any Connection Object not in the 


Non-Existent state. 
OEhex Conditional Get_Attribute_ | Used to read a Connection Class attribute value. This service is 
Single Required if any of the Connection Class Attributes are supported. 


3-4.3 Connection Class Object Specific Services 


The following class specific services are defined for the connection object class. 


Table 3-4.3 Connection Class Object Specific Services 


Service Need In Service Name Service Description 
Code (hex) | Implementation 
4Bhex Binds two connection instances 
4Chex Conditional’ | Producing Find established connections that are producing data from the 


Application application object specified by this service 
Lookup 


4Ehex SafetyClose See CIP Safety Specification 
54hex SafetyOpen (Volume 5, Chapter 3) 


1 This service is required if the Create service is supported. 
2 These services are not allowed if the device is not a safety device. If the device is a safety device, 
see Volume 5 


3-4.3.1 Connection Bind Service 


The Connection Bind object specific service binds two dynamically created I/O connection 
instances together for purposes of connection timeouts and deletions. A dynamically created 
I/O connection is the result of a Create service to the Connection class with the Instance_type 
attribute set to I/O (attribute value of 1). If one of these I/O connection instance times out or is 
deleted, the other instance shall exhibit the same behavior. 


The Connection Bind service has the following request parameter: 
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Table 3-4.4 Connection Bind Service Request Parameter 


Parameter Name Parameter Description 


Bound Instances STRUCT of | Instance numbers of connection objects to be bound. 


UINT 
UINT 


There is no response data. The service request may return a status from the following list of 
status codes: 


Table 3-4.5 Connection Bind Service Status Codes 


General Extended Status Description 
Status Code | Status Code 


0x02 0x01 One or both of the connection instances is non-existent. 
0x02 0x02 The connection class and/or instance is out of resources to bind instances. 


0x0C 0x01 Both of the connection instances are existent, but at least one is not in the 
Established state. 


0x20 0x01 Both connection instances are the same value. 


0xDO 0x01 One or both of the connection instances is not a dynamically created I/O 
connection. 


0xDO 0x02 One or both of the connection instances were created internally and the device is 
not allowing a binding to it. 


3-4.3.2 Producing Application Lookup Service 


The Producing Application Lookup object specific service provides a mechanism to find one or 
more connection instances in the Established state producing data from a given application 
object. If the requested producing application path is being produced by any connection in the 
Established state, the instance number of each connection producing from that path is returned. 


The Producing Application Lookup service has the following service request parameter: 


Table 3-4.6 Producing Application Lookup Service Request Parameter 


Parameter Name Parameter Description 


Producing 
Application Path 


Connection path of producing application to be searched for within 
connections in the Established state. The path shall be a single Logical or 
Symbolic EPATH. 


The Producing Application Lookup service has the following service response parameters: 


Table 3-4.7 Producing Application Lookup Service Response Parameter 


Parameter Name Data Type Parameter Description 
Instance Count UINT Number of Instances returned in the Connection Instance List parameter. 


Connection Instance | Struct of List of instance numbers of connection producing the data from the 
List UINT requested connection path within the node. 


The service request may return a status from the following list of status codes: 
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Table 3-4.8 Producing Application Lookup Service Status Codes 
General Extended Status Description 
Status Code | Status Code 


0x02 0x01 The connection path was not found in any connection instance in the Established 
state. 


3-4.4 Connection Object Instance Attributes 


The following list provides a summary of the Connection Instance attributes and their 
associated data types. 


Table 3-4.9 Connection Object Instance Attributes 


Attr ID Need In Attribute Name Data Brief Description of Attribute 
Implementation 


Required USINT State of the object 


PR 


uo 


2 Required Instance_type USINT Indicates either I/O or Messaging 
Connection 
3 Required TransportClass_trigger BYTE Defines behavior of the Connection 


UINT Placed in CAN Identifier Field when the 
Connection transmits on a DeviceNet 
subnet. Described in Vol 3, DeviceNet 
Adapation of CIP. 


UINT CAN Identifier Field value that denotes 
message to be received on a DeviceNet 
subnet. Described in Vol 3, DeviceNet 
Adaptation of CIP. 


BYTE Defines the Message Group(s) across which 
productions and consumptions associated 
with this Connection occur on a DeviceNet 
subnet. Described in Vol 3, DeviceNet 
Adaptation of CIP. 


IN Maximum number of bytes transmitted 
across this Connection 


4 Conditional DeviceNet_produced_ 


connection_id 


Conditional DeviceNet_consumed_ 


connection_id 


6 Conditional DeviceNet_initial_comm_ 


characteristics 


7 Required Produced_connection_size 


oO 


U 
U 


8 Required Consumed_connection_size INT Maximum number of bytes received across 
this Connection 

9 Required Expected_packet_rate UINT Defines timing associated with this 
Connection 

10 Conditional CIP_produced_connection_id Identifies the message sent on the subnet by 


this connection. 


11 Conditional CIP_consumed_connection_id | U Identifies the message received from the 


subnet for this connection. 


12 Required Watchdog _timeout_action Defines how to handle Inactivity/Watchdog 


timeouts 


13 Required Produced_connection_path_ UINT Number of bytes in the 
length produced_connection_path attribute 


Required Produced_connection_path Packed Specifies the Application Object(s) whose 
EPATH _ | data is to be produced by this Connection 
Object. See Appendix C. 


15 Required Consumed_connection_path_ | UINT Number of bytes in the 
length consumed_connection_path attribute 


16 Required Consumed_connection_path Packed Specifies the Application Object(s) that are 
EPATH _|to receive the data consumed by this 
Connection Object. See Appendix C. 


PR 
ows 
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Attr ID Need In Attribute Name Data Brief Description of Attribute 
Implementation Type 

17 Conditional Production_inhibit_time UINT Defines minimum time between new data 
production. This attribute is required for all 
I/O Client connections, except those with a 
production trigger of Cyclic. 

18 Optional Connection_timeout_multiplier | USINT | Specifies the multiplier applied to the 
expected_packet_rate value to derive the 
value for the Inactivity/Watchdog Timer. 


19 Conditional Connection_binding_list STRUCT | List of I/O connection instances bound to 
UINT this instance. 


Array of 
UINT 


Important: Access Rules for the Connection Object Instance Attributes are defined in section 
3-4.8. 


The list below provides detailed descriptions of the Connection Object Instance Attributes. 
The defined default attribute values are to be used when no other internal and/or 
system-defined rules exist. 


3-4.4.1 State, Attribute 1 - USINT data type 


This attribute defines the current state of the Connection instance. Table 3-4.10 defines the 
possible states and assigns a value used to indicate that state. Also see Figure 3-4.17 and 
Figure 3-4.20 for state transition behavior. 


Table 3-4.10 Values assigned to the state attribute 


Value State Name Description 
00 The Connection has yet to be instantiated 


01 Configuring The Connection has been instantiated and is waiting for the following events to occur: (1) to 
be properly configured and (2) to be told to apply the configuration. 


02 Waiting For The Connection instance is waiting exclusively for its consumed_connection_id and/or 
Connection ID? produced_connection_id attribute to be set. 


03 Established The Connection has been validly/fully configured and the configuration has been 
successfully applied. 

04 Timed Out If a Connection Object experiences an Inactivity/Watchdog timeout, then a transition may be 
made to this state. See the watchdog_timeout_action attribute description and the 
description of the Inactivity/Watchdog Timer (section 3-4.5) for more details. 


05 Deferred Delete” | If an Explicit Messaging Connection Object experiences an Inactivity/Watchdog timeout, 
then a transition may be made to this state. See the watchdog_timeout_action attribute 
description and the description of the Inactivity/Watchdog Timer (section 3-4.5) for more 
details. 


06 Closing A CIP Bridged connection object has received, and is processing, a Forward Close from the 
Connection Manager. The deletion of the connection does not occur until after a successful 
Forward Open response has been received from the target node. 


1 When the Connection instance attributes are applied it may not be possible for the module to generate the 
produced_connection_id and/or consumed_connection_id values (see initial_comm_characteristics 
attribute for rules). If this is the case then all the tasks required to apply the attributes are performed 
except for the initialization of these attributes within the Connection and associated Link 
Producer/Consumer Objects and a transition is made to this state. In this state the Connection instance is 
waiting exclusively for its produced_connection_id and/or consumed_connection_id attributes to be set. 

2__ This value is only used on DeviceNet. 
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3-4.4.2 


3-4.4.3 


Important: A dynamically created connection instance is the child of the Explicit Messaging 
connection across which it was created. Different subnet types may provide other mechanisms 
for creating a connection that imply a particular parent-child relationship. See network-specific 
specifications for details. 


Important: All resources associated with a Connection Instance (A) that has been dynamically 
created across an Explicit Messaging Connection (B) must be released if the Explicit 
Messaging Connection (B) times out prior to the dynamically created Connection Instance (A) 
transitioning to the Established state. 


Important: When a transition is made to the Established state, all timers associated with the 
Connection Object are activated (see section 3-4.5, Connection Timing) 


Instance_type, Attribute 2 - USINT data type 
This attribute defines the instance type. See Table 3-4.11. 


Table 3-4.11 Values assigned to the instance_type attribute 


Value Meaning 


00 Explicit Messaging. This Connection Instance represents one of the end-points of an Explicit 
Messaging Connection. An Explicit Messaging Connection is dynamically created by sending the 
Open Explicit Messaging Connection Request to the Connection Class. 


01 I/O. This Connection Instance represents one of the end-points of an I/O Connection. An I/O 
Connection is dynamically created by sending a Create Request to the Connection Class. 


02 CIP Bridged. This Connection Instance represents an intermediate ‘hop’ of a bridged I/O or Explicit 
Messaging connection. A pair of CIP Bridged connection objects (one for each subnet bridged 
between) are dynamically created by a node after successfully receiving a Forward Open service to 
the Connection Manager object when this node is not the end point (target). See Chapter 10 for 
additional information. 


TransportClass_trigger, Attribute 3 - BYTE data type 


Defines whether this is a producing only, consuming only, or both producing and consuming 
connection. If this end point is to perform a data production, this attribute also defines the event 
that triggers the production. The eight (8) bits are divided as follows: 
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Figure 3-4.2 Transport Class Trigger Attribute 


transportClass_trigger 


Production Transport 


r 
DP Trigger Class 


Transport Class 
0 = Class 0 
1=Class 1. 
2 = Class 2. 
3 = Class 3. 
"Production Trigger 
0 = Cyclic 
1 = Change-Of-State 
2 = Application Object 
——— Direction 
0 = Client 
1 = Server 


The Direction bit of the transportClass_trigger byte indicates whether the end-point is to act as 
the Client or the Server on this connection. The following values are defined: 


Table 3-4.12 Possible Values within Direction Bit 


Value Meaning 


This end-point provides the Client behavior associated with this Connection. 
Additionally, this value indicates that the Production Trigger bits within the 
transportClass_trigger byte contain the description of when the Client is to produce the 
message associated with this connection. Client connections with production trigger 
value of 0 or 1 (Cyclic or Change-of-State) shall produce immediately after 
transitioning to the Established state. 


This end-point provides the Server behavior associated with this Connection. In 
addition, this value indicates that the Production Trigger bits within the 
transportClass_trigger byte are to be IGNORED. The Production Trigger bits are 
ignored due to the fact that a Server end-point reacts to the transmission from the 
Client. The only means by which a Server end-point is triggered to transmit is when 
this reaction calls for the production of a message (Transport Classes 2 or 3). 


The following table lists the values that are possible within the Production Trigger bits of the 
transportClass_trigger attribute. 
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Table 3-4.13 Possible Values within Production Trigger Bits 


If the Then the Production of a message is: 
value is: 
0 Cyclic The expiration of the Transmission Trigger Timer triggers the data production. See 


section 3-4.5, Connection Timing for a detailed description of the Transmission Trigger 
Timer. 


1 Change-Of- | Production occurs when a change-of-state is detected by the Application Object. Note 

State that the consuming end-point may have been configured to expect the packet at a certain 
rate, regardless of the triggering mechanism at the producing end-point. See the 
description of the expected_packet_rate attribute of a Connection Object and the 
description of Connection Timing in section 3-4.5 for more information. 


2 Application | The Application Object decides when to trigger the production. Note that the consuming 
Object end-point may have been configured to expect the packet at a certain rate, regardless of 
Triggered | the triggering mechanism at the producing end-point. See the description of the 

expected_packet_rate attribute of a Connection Object and the description of Connection 

Timing in section 3-4.5 for more information. 


3-7 Reserved by CIP 


Table 3-4.14 lists possible values within the Transport Class nibble of the 
transportClass_trigger attribute. Behaviors resulting from these particular values are 
illustrated in the series of figures that follow the table. 


Table 3-4.14 Possible Values within Transport Class Bits 


Value Meaning 
0 Transport Class 0 | Based on the value within the Dir bit, this connection end-point will be a 
producing only OR consuming only end-point. Upon application of this 
1 Transport Class 1 Connection instance, the module instantiates either a Link Producer (Dir bit = 


Client, producing only) or a Link Consumer (Dir bit = Server, consuming 
only) to be associated with this Connection. 


2 Transport Class 2 | Indicates that the module will both produce AND consume across this 
connection. The Client end-point generates the first data production that is 

3 Transport Class 3 consumed by the Server, which causes the Server to return a production that is 

consumed by the Client. 


4 Transport Class 4} Non-blocking 
5 Transport Class5 | Non-blocking, fragmenting 
6 Multicast, fragmenting 
7-F Reserved 


A 16-bit sequence count value is prepended to all Class 1, 2, and 3 transports. This value is 
used to detect delivery of duplicate data packets. Sequence count values are initialized on the 
first message production and incremented on each subsequent new data production. A resend 
of old data shall not cause the sequence count to change, and a consumer shall ignore data 
when it is received with a duplicate sequence count. Consuming applications can use this 
mechanism to distinguish between new samples and old samples that were sent to maintain the 
connection. 
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The following tables and figures illustrate the valid combinations of Production Trigger and 
Transport Class and provides a description of the Client and Server behaviors. See section 3- 
4.5.1 for a description of the Transmission Trigger Timer, which is shown in the illustrations. 


3-4.4.3.1 Server Transport Class 0 and 1 Behavior 


Figure 3-4.3 Server Transport Class 0 and 1 Behavior 


Direction Production Transport 
i Trigger Bits Class Bits Meaning 


X (ignored) i, —— Oe | Server Transport Class 0. 


X (ignored) 1 Server Transport Class 1. The message 
received is prepended with a 16-bit 
sequence count value. 


Server Transport 
Class 0 and 1 Connection Object 


@ ~ 
~ 
Message received Q ~~ Application 


If Class 1 transport and the sequence count is the 
same as the previous message, notify the 
application that a duplicate message was received 
and discard data. Otherwise, the application is 
notified that consumption has occurred. 


— 3-18 —- 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Vol. 1: Common Industrial Protocol Specification, Chapter 3: Communication Object Classes 


3-4.4.3.2 Server Transport Class 2 Behavior 


Figure 3-4.4 Server Transport Class 2 Connection Object 


Direction | Production 
Bit Trigger Bits Meaning 


X (ignored) Server Transport Class 2. The act of consumption by the Link 
Consumer IMMEDIATELY triggers the associated Link 
Producer to transmit without intervention by the application. The 
message received is prepended with a 16-bit sequence count 
value. The message returned is prepended with this same 16-bit 


sequence count value. 
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3-4.4.3.3 Server Transport Class 3 Behavior 


Figure 3-4.5 Server Transport Class 3 Behavior 


Direction | Production | Transport 
Bit Trigger Bits | Class Bits Meaning 


X (ignored) 3 Server Transport Class 3. When the Link Consumer 
receives a message, it delivers it to the Application Object 
specified within the consumed_connection_path attribute. 
The Application Object then validates this receive data event 
(illustrated as #2 in the figure below). If the Application 
Object determines that the receive data event is valid, then it 
is REQUIRED to trigger a production as illustrated below. 
If the Application detects an error, then it may or may not 
trigger a production based on its own internal logic. The 
message received is prepended with a 16-bit sequence count 
value. The message returned is prepended with this same 16- 
bit sequence count value. 


Server Transport 
~s Class 3 Connection Object 


IMessage produced Link 


Producer 


Message consumed , If the sequence count is the same 
—_———_ as the previous message, notify 
the application that a duplicate 
message was received and discard 
data. Otherwise, notify the 
application that data has been 
consumed. 
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3-4.4.3.4 


Client Transport Class 0 and 1 Behavior: Cyclic 
Figure 3-4.6 Client Transport Class 0 and 1 Behavior: Cyclic 


Direction Production Transport 
i ae Bits Class Bits Meaning 


| 0 | Client Transport Class 0: Cyclic. 


1 _cten Transport Class 1: Cyclic. The message 


sent is prepended with a 16-bit sequence count 
value. 


Client Transport 
Class 0 and 1: Cyclic 
.¢ Transmission Trigger 
expires 


-— p> 
oon" ~— 


If Class 1 transport increment 
~- 


S sequence count on new data and 
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Transmission Trigger Timer 


CY 
sy 
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\ 


Application 


i} 
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J 
1 © 
Link Producer : Message production 


The Connection is 
told to produce 
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3-4.4.3.5 Client Transport Class 2 and 3 Behavior: Cyclic 


Figure 3-4.7 Client Transport Classes 2 & 3 Behavior: Cyclic 


Direction Production Transport 
i Trigger Bits Class Bits Meaning 
a 


Client Transport Class 2: Cyclic 


= ae sa a Client Transport Class 3: Cyclic 


For both transport class 2 and 3, a 16-bit sequence count value is prepended to the message 


before transmission. The message consumed due to this production is also prepended with a 16 
bit sequence count with a value equal to that of the sequence count sent. 
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3-4.4.3.6 Client Transport Class 0 and 1 Behavior: Change-Of-State 
Figure 3-4.8 Client Transport Class 0 and 1 Behavior: Change-Of-State 


Direction 
Meaning 


Client Transport Class 0: Change-of-State. 


Client Transport Class 1: Change-of-State. The 
message sent is prepended with a 16-bit sequence 
count value. 


Client Transport 


Class 0 and 1: Change-of-State 
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3-4.4.3.7 Client Transport Class 2 and 3 Behavior: Change-Of-State 
Figure 3-4.9 Client Transport Classes 2 & 3 Behavior: Change-Of-State 


Direction Production Transport 
i Trigger Bits Class Bits Meaning 


Client Transport Class 2: Change-of-State 


Client Transport Class 3: Change-of-State 


For both transport class 2 and 3, a 16-bit sequence count value is prepended to the message 
before transmission. The message consumed due to this production is also prepended with a 
16-bit sequence count with a value equal to that of the sequence count sent. 
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3-4.4.3.8 Client Transport Class 0 and 1 Behavior: Application Object Triggered 
Figure 3-4.10 Client Transport Class 0 and 1 Behavior: Application Object Triggered 


Direction Production Transport 
i ae Bits Class Bits Meaning 


Client Transport Class 0: Application Object 
Triggered. 


Client Transport Class 1: Application Object 
Triggered. The message sent is prepended with a 16-bit 
sequence count value. 


Client Transport 
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3-4.4.3.9 


Client Transport Class 2 and 3 Behavior: Application Object Triggered 
Figure 3-4.11 Client Transport Classes 2 & 3 Behavior: Application Object Triggered 


Direction Production Transport 
i Trigger Bits Class Bits Meaning 


Client Transport Class 2: Application Object Triggered 


Client Transport Class 3: Application Object Triggered 


For both transport class 2 and 3, a 16-bit sequence count value is prepended to the message 
before transmission. The message consumed due to this production is also prepended with a 
16-bit sequence count with a value equal to that of the sequence count sent. 
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To summarize, refer to the following table for the valid values within the 
transportClass_trigger attribute of a Connection Instance: 


Table 3-4.15 Transport Class_Trigger Attribute 


TransportClass_trigger 


bits Meaning 

1 xxx 0000 Direction = Server, Production Trigger = IGNORED, Transport Class = 0. 

1 xxx 0001 Direction = Server, Production Trigger = IGNORED, Transport Class = 1. 

1 xxx 0010 Direction = Server, Production Trigger = IGNORED, Transport Class = 2. 

1 xxx 0011 Direction = Server, Production Trigger = IGNORED, Transport Class = 3. This is the 
value assigned to this attribute within the Server end-point of an Explicit Messaging 
Connection. 

0 000 0000 Direction = Client, Production Trigger = Cyclic, Transport Class = 0. 

0 000 0001 Direction = Client, Production Trigger = Cyclic, Transport Class = 1. 

0 000 0010 Direction = Client, Production Trigger = Cyclic, Transport Class = 2. 

0 000 0011 Direction = Client, Production Trigger = Cyclic, Transport Class = 3. 

0 001 0000 Direction = Client, Production Trigger = Change-Of-State, Transport Class = 0. 

0 001 0001 Direction = Client, Production Trigger = Change-Of-State, Transport Class = 1. 

0 001 0010 Direction = Client, Production Trigger = Change-Of-State, Transport Class = 2. 

0 001 0011 Direction = Client, Production Trigger = Change-Of-State, Transport Class = 3. 

0 010 0000 Direction = Client, Production Trigger = Application Object, Transport Class = 0. 

0 010 00001 Direction = Client, Production Trigger = Application Object, Transport Class = 1 

0 010 0010 Direction = Client, Production Trigger = Application Object, Transport Class = 2. 

0010 0011 Direction = Client, Production Trigger = Application Object, Transport Class = 3. This 


is the value assigned to this attribute within the Client end-point of an Explicit 
Messaging Connection. 


11111111 Default value assigned to this attribute within an I/O Connection. 


3-4.4.4 DeviceNet_produced_connection_id, Attribute 4 — UINT data type 


This attribute is Required for a DeviceNet subnet. Other subnet types shall not use this 
attribute. See Volume 3, DeviceNet Adaptation of CIP, Chapter 3 for an explanation of this 
attribute. 


3-4.4.5 DeviceNet_consumed_connection_id, Attribute 5 — UINT data type 


This attribute is Required for a DeviceNet subnet. Other subnet types shall not use this 
attribute. See Volume 3, DeviceNet Adaptation of CIP, Chapter 3 for an explanation of this 
attribute. 


3-4.4.6 DeviceNet_initial_comm_characteristics, Attribute 6 - USINT data type 


This attribute is Required for a DeviceNet subnet. Other subnet types shall not use this 
attribute. See Volume 3, DeviceNet Adaptation of CIP, Chapter 3 for an explanation of this 
attribute. 
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3-4.4.7 


3-4.4.8 


Produced_connection_size, Attribute 7 — UINT data type 


The meaning of this attribute is different for Explicit Messaging Connections than it is for I/O 
Connections. If the subnet defines a fragmentation protocol and the device supports 
fragmentation, this size may be larger than the largest frame size. See the network specific 
adaptation specifications for more details. 


For Explicit Messaging Connections: 


This attribute signifies the maximum number of Message Router Request/Response Data octets 
(See CIP Common, Chapter 2) that a device is able to transmit across this Connection. Devices 
that place a known limit on the maximum amount of Message Router Request/Response Data 
that can be transmitted in a single message, or single fragmented series initialize this attribute 
accordingly. Devices that cannot or do not predefine an up-front transmit limit place the value 
Oxffff into this attribute (there may still be a limit, however, it is not known in advance). 


Important: Due to the nature of Explicit Messaging, the length of Explicit Messages will 
fluctuate over the lifetime of a connection. Explicit Messaging Connections perform 
fragmentation based on the length of the current message to transmit where the subnet type 
may define a fragmentation protocol. 


For I/O Connections: 


If the transportClass_trigger indicates that this Connection instance is to produce, then this 
attribute defines the maximum amount of I/O data that may be produced as a single unit across 
this connection. The amount of I/O to be transmitted at any given point in time can be less than 
or equal to the connection_size attribute. 


This attribute defaults to zero (0) within an I/O Connection. If the subnet type supports 
fragmentation and this attribute is set to a value greater than the largest payload in an I/O 
Connection, then the Connection will break up the data into multiple fragments. See the 
network specific adaptation specifications for more details. 


Important: Fragmentation within I/O Connections is performed based on the value within this 
attribute, regardless of the current amount of data to transmit. 


Important: I/O Messages that contain no Application I/O Data and were configured to contain 
data (via produced_connection_size being greater than zero (0)) are defined to indicate a No 
Data event for the receiving Application Object(s). The behavior of an Application Object 
upon detection of the No Data event is Application Object specific. 


Consumed_connection_size, Attribute 8 — UINT data type 


The meaning of this attribute is different for Explicit Messaging Connections than it is for I/O 
Connections. If the subnet defines a fragmentation protocol and the device supports 
fragmentation, this size may be larger than the largest frame size. See the network specific 
adaptation specifications for more details. 


For Explicit Messaging Connections: 


This attribute signifies the maximum number of Message Router Request/Response Data octets 
(See CIP Common, Chapter 2) that a device is able to receive across this Connection. 
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Devices that place a known limit on the maximum amount of Message Router 
Request/Response Data that can be received in a single message, or single fragmented series 
initialize this attribute accordingly. Devices that cannot or do not predefine an up-front receive 
limit place the value Oxffff into this attribute (there may still be a limit, however, it is not 
known in advance). Because of the nature of Explicit Messaging, the length of Explicit 
Messages will fluctuate over the lifetime of a connection. 


For I/O Connections: 


If the transportClass_trigger attribute indicates that this Connection is to consume, then this 
attribute defines the maximum amount of data that may be received as a single unit across this 
connection. The actual amount of I/O data received at any given time can be less than or equal 
to the connection_size attribute. 


This attribute defaults to zero (0) within an I/O Connection. If the subnet type supports 
fragmentation and this attribute is set to a value greater than the largest payload in an I/O 
Connection, then the Connection will process the fragmentation protocol. See the network 
specific adaptation specifications for more details. 


The length of an I/O Message must be less than or equal to this attribute for an I/O Connection 
Object to receive it as a valid message. If an I/O Connection Object receives a message whose 
length is greater than this attribute, then it immediately discards the message and discontinues 
any subsequent processing. Note that with respect to the Server end-point of a Transport Class 
2 or 3 Connection, this too much data error condition results in no response being transmitted 
and the watchdog timer is not kicked. 


Expected_packet_rate, Attribute 9 —- UINT data type 


This attribute is used to generate the values loaded into the Transmission Trigger Timer and the 
Inactivity/Watchdog Timer. See section 3-4.5, Connection Timing for a description of the 
Transmission Trigger and Inactivity/Watchdog timers. 


The resolution of this attribute is in milliseconds. A request to configure this attribute may 
result in the specification of a time value that a product cannot meet. In addition to performing 
product specific range checking when a request to modify this attribute is received, the 
following steps are performed: 


e If the specified value is not equal to an increment of the available clock resolution, then the 
value is rounded up to the next serviceable value. For example: a Set_Attribute_Single 
request is received specifying the value 5 for the expected_packet_rate attribute and the 
product provides a 10 millisecond resolution on timers. In this case the product would load 
the value 10 into the expected_packet_rate attribute. 

e = The value that is actually loaded into the expected_packet_rate attribute is reported in the 
Service Data Field of a Set_Attribute_Single response message associated with a request to 
modify this attribute. 

e If the requested value is equal to an increment of the clock resolution, then the requested 
value is loaded into the expected_packet_rate and reported in the response. For example: if 
the value 100 is requested and the clock resolution is 10 milliseconds, then of a value of 
100 is loaded. 
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3-4.4.10 


3-4.4.11 


3-4.4.12 


3-4.4.13 


When a Connection Object is in the Established state, any modifications to the 
expected_packet_rate attribute have immediate effect on the Inactivity/Watchdog Timer. 
The following steps are performed by a Connection Object in the Established state when a 
request is received to modify the expected_packet_rate attribute: 


e the current Inactivity/Watchdog Timer is canceled 


e anew Inactivity/Watchdog Timer is activated based on the new value in the 
expected_packet_rate attribute. 


This attribute defaults to 2500 (2500 milliseconds) within Explicit Messaging Connections, and 
to zero (0) within an I/O Connection. 


CIP_produced_connection_id, Attribute 10 - UDINT data type 


Contains the Connection ID, which identifies messages to be sent across this connection (if 
any). This attribute shall not be implemented when the subnet type is DeviceNet. 


CIP_consumed_connection_id, Attribute 11 — UDINT data type 


Contains the Connection ID, which identifies messages to be received across this connection (if 
any). This attribute shall not be implemented when the subnet type is DeviceNet. 


Watchdog_timeout_action, Attribute 12 — USINT data type 


This attribute defines the action the Connection Object should perform when the 
Inactivity/Watchdog Timer expires. The table below defines the specifics of this attribute. 


Table 3-4.16 Values for the watchdog_timeout_action 


Value Meaning 


0 Transition to Timed Out. The Connection transitions to the Timed Out state and remains in this state 
until it is Reset or Deleted. The command to Reset or Delete could come from an internal source (e.g., 
an Application Object) or could come from the network (e.g., a configuration tool). This is the default 
value for this attribute with respect to I/O Connections. This value is invalid for Explicit Messaging 
Connections. 


1 Auto Delete. The Connection Class automatically deletes the Connection if it experiences an 
Inactivity/Watchdog timeout. This is the default value for this attribute with respect to Explicit 
Messaging Connections. 


2 Auto Reset. The Connection remains in the Established state and immediately restarts the 
Inactivity/Watchdog timer. This value is invalid for Explicit Messaging Connections. 


3 Deferred Delete. The Connection transitions to the Deferred state if any child connection instances 
are in the Established state. If no child connection instances are in the Established state the 
connection is deleted. This value is only used on DeviceNet and is invalid for I/O Messaging 
Connections. 


4-FF | Reserved by CIP 


Produced_connection_path_length, Attribute 13 — UINT data type 


Specifies the number of bytes of information within the produced_connection_path attribute. 
This is automatically initialized when the produced_connection_path attribute is configured. 
This attribute defaults to the value zero (0). 
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3-4.4.14 


3-4.4.15 


3-4.4.16 


3-4.4.17 


Produced_connection_path, Attribute 14-— EPATH data type 


The produced_connection_path attribute is made up of a byte stream which defines the 
Application Object(s) whose data is to be produced by this Connection Object. ‘The format of 
this byte stream is specified in Appendix C, Abstract Syntax Encoding for Segment 
Types. This attribute defaults to being empty upon instantiation of the Connection. It remains 
empty within Explicit Messaging Connections and within Connection Objects that do not 
produce. 


Consumed_connection_path_length, Attribute 15 — UINT data type 


Specifies the number of bytes of information within the consumed_connection_path attribute. 
This is automatically initialized when the consumed_connection_path attribute is configured. 
This attribute defaults to the value zero (0). 


Consumed_connection_path, Attribute 16 - EPATH data type 


The consumed_connection_path attribute is made up of a byte stream which defines the 
Application Object(s) that are to receive the data consumed by this Connection Object. The 
format of this byte stream is specified in Appendix C, Abstract Syntax Encoding for 
Segment Types. This attribute defaults to being empty upon instantiation of the Connection. It 
remains empty within Explicit Messaging Connections and within Connection Objects that do 
not consume. 


Production_inhibit_time, Attribute 17 — UINT data type 


This attribute is used to configure the minimum delay time between new data production. This 
is required for all I/O Client connections, except those with a production trigger of Cyclic. The 
Set_Attribute_Single service must be supported when this attribute is implemented. A value of 
zero (the default value for this attribute) indicates no inhibit time. 


The resolution of this attribute is in milliseconds. A request to configure this attribute may 
result in the specification of time value that a product cannot meet. In addition to performing 
product specific range checking when a request to modify this attribute is received, the 
following steps are performed: 


e If the specified value is not equal to an increment of the available clock resolution, then the 
value is rounded up to the next serviceable value. For example: a Set_Attribute_Single 
request is received specifying the value 5 for the production_inhibit_time attribute and 
the product provides a 10 millisecond resolution on times. In this case the product would 
load the value 10 into the production_inhibit_time attribute. 

e The value that is actually loaded into the production_inhibit_time attribute is reported in 
the Service Data Field of a Set_Attribute_Single response message associated with a 
request to modify this attribute. 

e If the requested value is equal to an increment of the clock resolution, then the requested 
value is loaded into the production_inhibit_time and reported in the response. For 
example: the value 100 is requested and the clock resolution is 10 milliseconds. 


The production_inhibit_time value is loaded in the Production Inhibit Timer each time new 
data production occurs. 
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3-4.4.18 


3-4.4.19 


3-4.5 


3-4.5.1 


When a Connection Object is in the Established state, any modifications to the 
production_inhibit_time attribute have no effect on a currently running Production Inhibit 
Timer. The new production_inhibit_time value is loaded into the Production Inhibit Timer on 
the following new data production. 


When the apply_attributes service is received, the production_inhibit_time must beverified 
against the expected_packet_rate attribute. If the expected_packet_rate value is greater than 
zero, but less than the production_inhibit_time value, then an error shall be returned. In this 
case, where two attribute values conflict use the production_inhibit_time attribute ID as the 
additional error code returned in the error response. 


Connection_timeout_multiplier, Attribute 18 -USINT data type 


The Connection_timeout_multiplier specifies the multiplier applied to the expected packet rate 
to obtain the value used by the Inactivity/Watchdog Timer. See the Connection Timeout 
Multiplier parameter description within the Connection Manager Object Specific Service 
Parameters for the enumerated values of this attribute. The default value for this attribute is 
zero (specifying a multiplier of 4). 


Connection_binding_list, Attribute 19 — Struct(UINT(size), Array of UINT[size]) 
data type 


The Connection_binding_list attribute identifies connection instances that are bound to this 
connection. The attribute structure provides a 16 bit count of bound connections, followed by a 
list of the bound instances. This attribute shall be supported if the Connection Bind service is 
supported. 


Connection Timing 


Three types of timers are involved in a connection: 


e Transmission Trigger Timer 
e Inactivity/Watchdog Timer 
e Production Inhibit Timer 


The first two timers are initialized based on the value in the expected_packet_rate attribute. 


Important: For Explicit Messaging, the Application is responsible for providing response 
timeout facilities. The amount of time a Client waits for a Server to respond to a request 
depends on the application and, possibly, on the service. Due to Media Access mechanisms 
used for accessing the subnet, an implementation should wait until an Explicit Request 
Message is transmitted before activating any response related timers. 


Transmission Trigger Timer 


This timer is required to be managed by the application within the Client end-point of a 
Connection. Expiration of this timer is an indication that the associated Connection Object_may 
need to be told to transmit a message. If a production has not occurred since the timer was 
activated, then the Connection Object should be told to produce to avoid an 
Inactivity/Watchdog timeout at the Server end-point(s). 


The tasks listed below are performed by a Connection immediately upon producing a message 
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e The current value of the Transmission Trigger Timer is restored to its initial value and the 
timer is stopped. 
e Anew Transmission Trigger Timer is activated. 


Figure 3-4.12 Transmission Trigger Timer 
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As illustrated in Figure 3-4.12, when the Transmission Trigger Timer expires, it is immediately 
re-started. This timer is activated when the Connection transitions to the Established state. 


Important: The Transmit Trigger Timer is initialized with the value in the 
expected_packet_rate attribute. If the expected_packet_rate attribute contains the value zero 
(0), then the Transmission Trigger Timer is not activated and/or used by the Client end-point. 


Important: Server end-points do not activate this timer. 


Inactivity/Watchdog Timer 


This timer is required to be managed by any consuming Connection Object. Consuming 
Connection Objects include: 


e Client end-point Connection Objects whose transportClass_trigger attribute indicates either 
Transport Class 2 or 3 
e ~All Server end-point Connection Objects 


This timer is activated when the Connection transitions to the Established state. The tasks 
listed below are performed by a Connection immediately upon detecting that a valid message 
has been consumed: 


e The current value for the Inactivity/Watchdog Timer is restored to its initial value and the 
timer is stopped. 
e Anew Inactivity/Watchdog Timer is activated. 


The bullet items above indicate that the new Inactivity/Watchdog Timer is activated before the 
received message is processed. 
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Expiration of this timer is an indication that the Connection Object has timed out while waiting 
to consume. The Connection Object performs the following steps when the 
Inactivity/Watchdog timer expires: 


e issues an indication of this event to the application 


e performs the action indicated by the watchdog_timeout_action attribute 


Figure 3-4.13 Inactivity Watchdog Timer 
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Two different values are used for the Inactivity/Watchdog Timer, based on whether or not the 
Connection Object has consumed a message: 


1. The initial value loaded into the Inactivity/Watchdog Timer is either 10,000 milliseconds 
(10 seconds) or the expected_packet_rate multiplied by the 
connection_timeout_multiplier, depending on which value is numerically greater’. If the 
expected_packet_rate attribute multiplied by the connection_timeout_multiplier is 
greater than 10,000, then the expected_packet_rate multiplied by the 
connection_timeout_multiplier is used. Otherwise, 10,000 (10 seconds) is used. This is 
referred to as the pre-consumption timeout value. This value is used because a Connection 
may transition to the Established state before all end-points are fully configured. For 
example: 


1 If the expected_packet_rate attribute contains the value zero (0), then the Inactivity/Watchdog Timer is 
not activated and/or used by the Connection Object. A Connection Object whose expected_packet_rate 
attribute is zero (0) will never experience an Inactivity/Watchdog timeout. 
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The tool configures the server endpoint of a connection within device B. The tool sends an Apply Request, 
which causes the transition to the Established rate and activates the Inactivity/Watchdog Timer. 


1/O Connection 
Object 


Device B 


The tool configures the client endpoint of the connection. While performing this configuration, the Server 
endpoint times out due to the fact that a low expected_packet_rate was specified. 


J/O Connection 
Object 


Device A 


This rule takes into consideration that the application-to-application connection is not really 
established until the associated information exchange is performed for the first time. 


2. All subsequent activations of the Inactivity/Watchdog Timer use the expected_packet_rate 
multiplied by the connection_timeout_multiplier as the number of milliseconds to load 
into the Inactivity/Watchdog Timer 1. 


3-4.5.3 Production Inhibit Timer 


This timer is required to be managed by the Connection Object within the Client end-point of 
an I/O Connection when the production_inhibit_time attribute value is non-zero. This timer 
is started when data is produced by the Connection Object. The Connection Object may not 
produce new data if this timer is running. A retry may, however, be sent to the Link Producer. 
Expiration of this timer allows the Connection Object to send new data. 


1 If the expected_packet_rate attribute contains the value zero (0), then the Inactivity/Watchdog Timer is 
not activated and/or used by the Connection Object. A Connection Object whose expected_packet_rate 
attribute is zero (0) will never experience an Inactivity/Watchdog timeout. 
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Figure 3-4.14 Production Inhibit Timer 
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Important: The Production Inhibit Timer is initialized with the value in the 
production_inhibit_time attribute. If the production_inhibit_time attribute contains the 
value zero (0), then the Production Inhibit Timer is not activated and/or used by the Client end- 
point. 

Important: Server end-points do not activate this timer. 


3-4.6 Connection Object Instance Services 


The Connection Object Instance supports the following CIP Common services: 


Table 3-4.17 Connection Object Instance Services 


Service Need In Service Name Service Description 
Code | Implementation 
OEhex Get_Attribute_ Used to read a Connection Object attribute. 
Single 


10hex | Optional Set_Attribute_ Used to modify a Connection Object attribute. The Connection 
Single Object returns information in the Service Data Field of a 
Set_Attribute_Single Response when the expected_packet_rate 
attribute is modified as indicated in Table 3-4.19 


O5hex | Optional 


Used to reset the Inactivity/Watchdog Timer associated with a 
Connection Object. When a Connection in the Timed Out or 
Deferred Delete state receives a Reset request it also transitions 
back to the Established state. 


O9hex | Optional Delete Used to delete a Connection Object and to release all associated 
resources. 
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Service Need In Service Name Service Description 
Code | Implementation 


ODhex | Optional Apply_Attributes | Used to deliver the Connection Object to the application, which 
performs the set of tasks necessary to create the specified 
connection. A Connection Instance returns the 
produced_connection_id and consumed_connection_id 
attributes within the Service Data field of an Apply Attributes 
Response Message as indicated in Table 3-4.18. The 
Apply_Attributes service effectively states that the initial 
configuration of the Connection Object is complete and it is now 
time to ” activate” that configuration. 


The following information is specified by a Connection Object Instance within the Service 
Data Field of a successful Apply_Attributes response. 


Table 3-4.18 Service Data For Connection Object Apply Attributes Response 


Name Description of Parameter 


Contains the value within the Connection Instance’s 
produced_connection_id attribute. If the subnet type is 
DeviceNet, the DeviceNet_produced_connection_id attribute is 
used. 


Produced Connection ID 


Contains the value within the Connection Instance’s 
consumed_connection_id attribute. If the subnet type is 
DeviceNet, the DeviceNet_consumed_connection_id attribute is 
used. 


Consumed Connection ID 
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Figure 3-4.15 below illustrates the Apply_Attributes service sent to a Connection Object 
Instance. For this example, assume a DeviceNet Explicit Messaging Connection was 
established across Group 2 and the Message Body Format was defined by the Server as 
DeviceNet (16/16). 


Figure 3-4.15 Apply_Attributes Service Example 


Client Server 
MAC ID =0A MAC ID=2 


Group 2 Message 
Destination MAC ID =2 


Assume the Server allocated Group 2 Message ID 1 to the client 
Frag =0, Transaction ID =0, Source MAC ID = 0A (Destination in Identifier) 
Service = Apply Attributes Request 
Class 5 (Connection Class Object) 
a Instance ID = 02 


Identifier = 10 000010 001, Data=0A OD 0500 0200 


Group 2 Message 


Source MAC ID =2 
Assume the Server allocated Group 2 Message ID value 4 for itself 
Frag =0, Transaction ID =0, Destination MAC ID = 0A (Source in Identifier) 
Service = Apply Attributes Response (Success) 
Connection Instance #2’s produced_connection_id attribute value 
= Connection Instance #2’s consumed_connection_ id attribute value 


Identifier = 10 000010 100, Data =0A 8D 4200 0500 


The following information is specified by a Connection Object Instance within the Service 
Data Field of a successful Set_Attribute_Single response associated with the modification of 
the expected_packet_rate attribute. 


Table 3-4.19 Service Data For Set_Attribute_Single [expected_packet_rate] Response 


Name Description of Parameter 


Expected Packet Rate Contains the actual value within the Connection 


Instance’s expected_packet_rate attribute. 


The illustration in Figure 3-4.16 depicts a Client requesting that the expected_packet_rate be 
set to 5 milliseconds. The Server returning a successful response stating that the attribute was 
actually set to 10 milliseconds. 


For this example, assume a DeviceNet Explicit Messaging Connection was established across 
Group 2 and the Message body Format was defined by the Server as DeviceNet (8/8). Assume 
also that the expected_packet_rate attribute of Connection Instance #1 is requested to be set to 
5 milliseconds but the product supports a 10 millisecond resolution. 
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Figure 3-4.16 Set Expected Packet Rate Example 


Client Server 
MAC ID=0A MAC ID =2 


Group 2 Message 
Destination MAC ID =2 
Assume the Server allocated Group 2 Message ID 1 to the 
client Frag = 0, Transaction ID =0, Source MACID = 0A (Destination in Identifier) 


Service = Set Attribute Single Request 
Class 5 (Connection Class Object) 
Instance ID = 02 
Attribute ID = 09 
= Service Data (attribute value = 5 milliseconds) 


Identifier = 10 000010 001, Data=0A 10 05 02 09 0500 


Group 2 Message 


Source MAC ID =2 
Assume the Server allocated Group 2 Message ID value 4 for itself 
Frag =0, Transaction ID =0, Destination MAC ID =0A (Source in Identifier) 
Service = Set Attribute Single Response (Success) 
hap Service Data (attribute value = 10 milliseconds) 


Identifier = 10 000010 100, Data =O0A 90 0A00 


The Connection Object does not return any information in the Service Data Field of a 
Set_Attribute_Single response directed towards any other of its attributes. 


The Connection Object also supports the following internal services: 


e Send_Message - Used internally to trigger the transmission of a message. This results in 
the invocation of the associated Link Producer’s Send service. If the message needs to be 
transmitted in a fragmented fashion, this service breaks up the message into multiple 
fragments and invokes the associated Link Producer’s Send service multiple times. 

e Receive_Data - Used internally to deliver a received frame to the Connection Object. This 
service is invoked internally by a Link Consumer. The Connection Object is responsible for 
determining whether or not it must reassemble a series of data fragments into a complete 
message before processing the message. 


3-4.7 Connection Instance Behavior 


3-4.7.1 I/O Connection Instance Behavior 


Figure 3-4.17 provides a general overview of the behavior associated with an I/O Connection 
Object (instance_type attribute = I/O). 
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Figure 3-4.17 I/O Connection Object State Transition Diagram 
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A Connection Object issues the internal indications described in Figure 3-4.18 to an application 
within a product. The purpose of this specification is to describe externally visible behaviors; 
rules pertinent to specific internal indications are not defined. 


Figure 3-4.18 Internal Indications Issued by a Connection Object (Conceptual) 
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Important: Table 3-4.20 provides a detailed State Event Matrix for an I/O Connection Object 
and implementations should be based on this information. This State Event Matrix does not 
dictate rules with regards to product specific, internal logic. Any attempt to access the 
Connection Class or a Connection Object Instance may need to pass through product specific 
verification. This may result in an error scenario that is not indicated by the SEM in Table 3- 
4.20. This may also result in additional, product specific indications delivered from a 
Connection Object to the application and/or a specific Application Object. The point to 
remember is that the Connection Object must exhibit the externally visible behavior specified 
by the SEM and the attribute definitions (section 3-4.4). 


Table 3-4.20 I/O Connection State Event Matrix 


1/O Connection Object State 


Non-Existent Configuring Waiting for Established Timed Out 
Event Connection ID 


Connection 
Class receives 
a Create 
Request 


Connection 
Class receives 
a Delete 
Request 


Set_Attribute_ 
Single 


Get_Attribute_ 
Single 


Class instantiates 
a Connection 
Object. Set 
instance_type to 
V/O. Set all other 
attributes to 
default values. 
Transition to 
Configuring 


Not applicable 


Release all associated 
resources. Transition to 
Non-existent 


Error: Object 
does not exist 
(General Error 
Code 16hex) 


Error: Object 

does not exist 

(General Error 
Code 16hex) 


Validate/service the 
request based on internal 
logic and per the Access 
Rules presented in 
section 3-4.8. Return 
response. 


Validate/service the 
request based on internal 
logic and per the Access 
Rules presented in 
section 3-4.8. Return 
response. 


Error: Object 
does not exist 
(General Error 
Code 16hex) 


Not applicable 


Release all associated 
resources. Transition to 
Non-existent. 


If request to modify 
produced or 
consumed_connection_id 
then validate the value 
and service the request. 
Return appropriate 
response. If this is a 
request to access an 
attribute other than the 
produced or 
consumed_connection_id 
, then return an Error 
Response whose General 
Error Code is set to 
OChex (The object can 
not perform the requested 
service in its current 
mode/state) 


Validate/service the 
request based on internal 
logic and per the Access 
Rules presented in 
section 3-4.8. Return 
response. 
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Not applicable 


Release all associated 
resources. Transition 
to Non-existent. 


Validate/service the 
request based on 
internal logic and per 
the Access Rules 
presented in section 3- 
4.8. Return 
appropriate response. 


Validate/service the 
request based on 
internal logic and per 
the Access Rules 
presented in section 3- 
4.8. Return response. 


Not applicable 


Release all associated 
resources. Transition 
to Non-existent. 


Validate/service the 
request based on 
internal logic and per 
the Access Rules 
presented in section 
3-4.8. Return 
appropriate response. 


Validate/service the 
request based on 
internal logic and per 
the Access Rules 
presented in section 
3-4.8. Return 
response. 
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Reset 


Event 


Non-Existent Configuring Waiting for Established 
Connection ID 


Error: The object cannot 


Error: Object 

does not exist 

(General Error 
Code 16hex) 


Error: The object cannot 


perform the requested 
service in its current 
mode/state. (General 
Error Code value =) 


1/O Connection Object State 


perform the requested 
service in its current 
mode/state. (General 
Error Code value = 
OChex) 
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Cancel the current 
Inactivity/Watchdog 
Timer. Using the 
value in the 
expected_packet_rate 
attribute, re-start the 
Inactivity/Watchdog 
Timer. A success 
response is returned 
even if an 
Inactivity/Watchdog 
Timer is not utilized 
by the Connection 
Object (Client 
Transport Class 0, 
expected_packet_rate 
= 00Chex). 


Timed Out 


Using the value in the 
expected_packet_rate 
attribute, start the 
Inactivity/Watchdog 
timer and transition 
back to the 
Established state. 


If the 
expected_packet_rate 
attribute has been set 
to zero (0) while the 
Connection was in 
the Timed Out state, 
then just transition 
back to Established 
without activating an 
Inactivity/Watchdog 
Timer. 
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Event 


Apply_ 
Attributes 


Error: Object 

does not exist 

(General Error 
Code 16hex) 


Deliver Connection 
Object to the application 
which validates the 
attribute information. If 
either of the 
connection_id attributes 
(produced or consumed) 
needs to be configured 
and cannot be generated 
by this module, then 
perform all the other 
steps necessary to 
configure the connection, 
return a Successful 
Response and transition 
to the Waiting For 
Connection ID state. The 
inability to generate a 


produced or consumed 
connection ID value IS 
NOT reported as an 


error. If all attributes are 
validly configured, then 
perform all the steps 
necessary to satisfy this 
connection, start all 
required timers, and 
transition to the 
Established state. If an 
error is detected, then an 
Error Response is 
returned and the 
Connection remains in 
the Configuring state’ 
and, if a Client 
Connection with a 
production trigger value 
of 0 or 1 (Cyclic or 
Change of State), 
produce initial data. 


If either of the 
connection_id attributes 
(produced or consumed) 
still needs to be 
configured and cannot be 
generated by this module, 
then return a Successful 
Response and remain in 
the Waiting For 
Connection ID state. The 
inability to generate a 
produced or consumed 
connection ID value IS 
NOT reported as an 
error. If the produced 
and/or 
consumed_connection_id 
attributes are now validly 
configured, then 
transition to the 
Established state and 
return a Successful 
Response1 and, if a 
Client Connection with a 
production trigger value 
of 0 or 1 (Cyclic or 
Change of State), 
produce initial data. 
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1/O Connection Object State 


Non-Existent Configuring Waiting for Established 
Connection ID 


All modifications take 
place immediately 
once the Connection 
has transitioned to the 
Established state. 
Return Error: The 
object cannot perform 
the requested service 
in its current 
mode/state. (General 
Error Code value = 
OChex) 


Timed Out 


Error: The object 
cannot perform the 
requested service in 
its current 
mode/state. (General 
Error Code value = 
OChex) 
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1/O Connection Object State 


Non-Existent Configuring Waiting for Established Timed Out 
Event Connection ID 


Receive_Data | Not applicable Discard the message Discard the message If a complete, valid? | Discard the message 
message has been 
received, reset the 
Inactivity/Watchdog 
Timer ? and deliver the 
1/O Message to the 
Application. A 
Connection Object 
must exhibit the 
externally visible 
behavior associated 
with the current state 


of its attributes (see 


section 3-4.4). If this 


is a fragmented portion 
of an I/O Message, 
process as specified by 
subnet. 


Send_Message | Not applicable Return internal error - do | Return internal error - do | Transmit the complete | Return internal error - 
not send the message not send the message 1/O Message or do not send the 
fragment as required | message 
by the subnet. If this is 
a Client Connection 
and the 
expected_packet_rate 
attribute is non-zero, 
restart the 
Transmission Trigger 
Timer. 
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1/O Connection Object State 


Non-Existent Configuring Waiting for Established Timed Out 
Event Connection ID 


Inactivity/ Not applicable Not applicable Not applicable Examine the Not applicable 
Watchdog watchdog_timeout_act 
ion attribute of the 
Connection and 
perform the indicated 
action. If the 
watchdog_timeout_act 
ion attribute indicates 
that the Connection is 
to remain in the 
Established state (Auto 
Reset), then 
immediately re-start 
the 
Inactivity/Watchdog 
Timer. 


Timer expires 


1 If the configuration indicates that a Message ID needs to be allocated and an available Message ID does not exist in the 
specified Message Group, then an Error Response whose General Error Code indicates Resource Unavailable (02hex) is 
returned. If a Connection Object attribute value passed the range check when it was initially configured but the attribute 
value conflicts with another piece of information in the node when the Apply request is processed, then an Error 
Response is returned whose General Error Code is set to Invalid Attribute Value (O9hex) and whose Additional Code is 
set to the Attribute ID of the offending Connection Object Attribute ID. 

2 The Connection Object verifies that the length of the received I/O Message is less than or equal to the 
consumed_connection_size attribute prior to processing the message. If the length of the received message is less than or 
equal to the consumed_connection_size attribute, then the I/O Connection Object resets the Inactivity/Watchdog Timer, 
exhibits the externally visible behavior indicated by its attribute settings, and delivers the message to the Application. If 
the length of the received message is greater than the consumed_connection_size attribute, then the I/O Connection 
Object immediately discards the message and discontinues any subsequent processing. This is the only message content 
validation performed by an I/O Connection Object. Subsequent validation must be performed by the Application. 

3 Ifa fragmented message is being received, then the Inactivity/Watchdog Timer is not reset until the entire message has 
bee validly received. 


Important: The Receive_Data event is only delivered to an I/O Connection when a message 
whose Connection Identifier Field matches the consumed_connection_id attribute is received. 
If a message is received whose Connection Identifier Field does not match any Established 
Connection Object’s consumed_connection_id attribute, then the message is discarded. 
Connection Identifiers are subnet-type specific. 


If an implementation detects that it does not support an Explicit Messaging Service indicated in 
Table 3-4.20, then an Error Response specifying Service Not Supported (General Error Code 
08) is returned. 


3-4.7.2 CIP Bridged Connection Instance Behavior 


Figure 3-4.19 provides a general overview of the behavior associated with a CIP Bridged 
Connection Object (instance_type attribute = CIP Bridged). CIP Bridged connections are 
used to make connections offlink. Both I/O and Explicit Messaging can be accomplished using 
this connection type. The Connection Manager Object definition provides more details these 
types of connections. 
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Figure 3-4.19 CIP Bridged Connection Object State Transition Diagram 


Non-Existent 


Forward Open (to 
Connection Manager) 


Configuring 


Forward Open 
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Forward Close 
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Connection 
Timeout 


Forward Close 
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Table 3-4.21 provides a detailed State Event Matrix for a CIP Bridged Connection Object. 


Table 3-4.21 CIP Bridged Connection State Event Matrix 


CIP Bridged Connection Object State 


Event Non-Existent Configuring Established Closing 
Connection Manager | Connection Class Not applicable Not applicable Not applicable 
receives a Forward instantiates a 
Open Request Connection Object. 

Set instance_type 
to CIP Bridged. 
Set attributes to 
value delivered by 
Forward Open 
service or default 
for CIP Bridged 
connections. 
Transition to 
Configuring. 
Connection Manager | Not applicable Transition to Not applicable Not applicable 
receives notification Established 
that connection 
establishment is 
complete to target 
Connection Manager | Not applicable Ignore event Transition to Ignore event 
receives a Forward Closing 
Close Request 
Connection Manager | Not applicable Release all Release all Release all 


receives a Forward 
Close Response 


resources and 
transition to Non- 
Existent 


resources and 
transition to Non- 
Existent 


resources and 
transition to Non- 
Existent 


Delete 


Error: Object does 
not exist (General 
Error Code 16nex) 


Release all 
resources and 
transition to Non- 
Existent 


Release all 
resources and 
transition to Non- 
Existent 


Release all 
resources and 
transition to Non- 
Existent 
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3-4.7.3 


Event 


CIP Bridged Connection Object State 


Non-Existent 


Configuring 


Established 


Closing 


Get_Attribute_Single 


Error: Object does 
not exist (General 
Error Code 16hex) 


Set_Attribute_Single 


Error: Object does 
not exist (General 
Error Code 16hex) 


Validate/service 
the request based 
on internal logic 
and per the Access 
Rules presented in 
section 3-4.8. 
Return appropriate 
response. 


Validate/service the 
request based on 
internal logic and 
per the Access 
Rules presented in 
section 3-4.8. 
Return appropriate 
response. 


Validate/service the 
request based on 
internal logic and 
per the Access 
Rules presented in 
section 3-4.8. 
Return appropriate 
response. 


Reset 


Error: Object does 


Error: Service Not 


Error: Service Not 


Error: Service Not 


not exist (General Supported Supported (General | Supported (General 
Error Code 16hex) (General Error Error Code O8hex) Error Code O8hex) 
Code 08hex) 
Apply_Attributes Error: Object does Error: Service Not | Error: Service Not Error: Service Not 
not exist (General Supported Supported (General | Supported (General 
Error Code 16hex) (General Error Error Code O8hex) Error Code O8hex) 
Code 08hex) 
Receive_Data Not applicable Ignore event Invoke send service | Ignore event 
of connection object 
on destination port, 
passing the received 
data. 
Send_Message Not applicable Ignore event Send data on subnet. | Ignore event 
Inactivity/Watchdog | Not applicable Not applicable Release all Release all 


Timer expires 


resources and 
transition to Non- 
Existent 


resources and 
transition to Non- 
Existent 


Explicit Messaging Connection Instance Behavior 


Figure 3-4.20 provides a general overview of the behavior associated with an Explicit 
Messaging Connection Object (instance_type attribute = Explicit Messaging). 


Figure 3-4.20 Explicit Messaging Connection Object State Transition Diagram 


Non-Existent 
Delete 


Open Explicit Messaging Connection 
Response Transmitted by a Server end-point 


Delete 
Child instance 


Deleted or Transitions 
to Timed Out and no 
other child instances 
are in the Established 
state 


Inactivity/W atchdog Timeout & 
watchdog_timeout_action = 
Auto Delete or this attribute is set 
to Deferred Delete and no child 
instances are in the Established 
state 


Open Explicit Messaging Connection 
Response Received _by a Client end-point 


Inactivity/Watchdog Timeout & 
watchdog_timeout_action = 
Deferred Delete and at least one 
child instance is in the Established 
state 


Get_Attribute/ 
Set_Attribute/ 
Reset 


Deferred Delete Established 


Receive Data / Reset 
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Table 3-4.22 provides a detailed State Event Matrix for an Explicit Messaging Connection 
Object. Implementations should be based on the information in Table 3-4.22. 


Table 3-4.22 Explicit Messaging Connection State Event Matrix 


Event 


UCMM receives an 
Open Explicit 
Messaging 
Connection 
Request/Response 
and invokes the 
Create service of the 
Connection Class 


UCMM receives a 
Close Request and 
invokes the Delete 
service of the 
Connection Class 


Connection Class 
receives a Delete 
Request 


Set_Attribute_Single 


Get_Attribute_Single 


Reset 


Apply_Attributes 


Explicit Messaging Connection Object State 


If possible, Class 
instantiates Connection 
Object. Set instance_type 
attribute to Explicit 
Messaging *. Other 
attributes are automatically 
configured using the 
information in the Open 
Explicit Messaging 
Connection 
Request/Response. 
Transition to Established. 
If request received, 
Transmit Open Explicit 
Messaging Connection 
Response. 


Error: Object does not exist 
(General Error Code 16hex) 


Error: Object does not exist 
(General Error Code 16hex) 


Error: Object does not exist 
(General Error Code 16hex) 


Error: Object does not exist 
(General Error Code 16hex) 


Error: Object does not exist 
(General Error Code 16hex) 


Error: Object does not exist 
(General Error Code 16hex) 


Not applicable 


Release all associated 
resources. Transition to 
Non-existent. 


Release all associated 
resources. Transition to 
Non-existent. 


Validate/service the request 
based on internal logic and per 
the Access Rules presented in 
section 3-4.8. Return 
appropriate response. 


Validate/service the request 
based on internal logic and per 
the Access Rules presented in 
section 3-4.8. Return 
appropriate response. 


Cancel the current 
Inactivity/Watchdog Timer. 
Using the value in the 
expected_packet_rate 
attribute, re-start the 
Inactivity/Watchdog Timer. 


Error: The object cannot 
perform the requested service 
in its current mode/state. 
(General Error Code value = 
OChex) 
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Deferred Delete 


Not applicable 


Release all associated 
resources. Transition to 
Non-existent. 


Release all associated 
resources. Transition to 
Non-existent. 


Validate/service the request 
based on internal logic and 
per the Access Rules 
presented in section 3-4.8. 
Return appropriate 
response. 


Validate/service the request 
based on internal logic and 
per the Access Rules 
presented in section 3-4.8. 
Return appropriate 
response. 


Using the value in the 
expected_packet_rate 
attribute, re-start the 
Inactivity/Watchdog Timer 
and transition back to the 
Established state. 


Error: The object cannot 
perform the requested 
service in its current 
mode/state. (General Error 
Code value = 0Chex) 


Vol. 1: Common Industrial Protocol Specification, Chapter 3: Communication Object Classes 


Explicit Messaging Connection Object State 


Receive_Data Not applicable If a valid message or message __| If a valid message or 
fragment has been received, message fragment has been 
then reset the received, then restart the 
Inactivity/Watchdog Timer’. Inactivity/Watchdog Timer’ 
Either process/store the and transition back to the 
fragment or handle the Explicit | Established state. Either 
Message. process/store the fragment 

or handle the Explicit 

Message. 


Send_Message Not applicable Examine the length of the Examine the length of the 
message to transmit and, if message to transmit and, if 
necessary, perform a necessary, perform a 
fragmented series of fragmented series of 
transmissions. Otherwise, transmissions. Otherwise, 
transmit the complete Explicit | transmit the complete 
Message. Explicit Message. 


Inactivity/Watchdog | Not applicable If the Not applicable. 

Timer watchdog_timeout_action 

expires attribute is set to Auto Delete or 
is set to Deferred Delete and no 
child connection instances are 
in the Established state release 
all associated resources and 
Transition to Non-existent. If 
the watchdog_timeout_action 
attribute is set to Deferred 
Delete and at least one child 
connection instance is in the 
Established state transition to 
Deferred Delete 


If no other child connection 
instances are in the 
Established state release all 
associated resources and 
transition to Non-existent. 


Child connection Not applicable Ignore event 
instance Deleted or 
Transitions to Timed 
Out 


1 If the configuration indicates that a connection resource needs to be allocated and an available 
resource does not exist, then an Error Response who’s General Error Code indicates Resource 
Unavailable (02hex) is returned. 

2 On DeviceNet, the MAC ID field within the Message Header of all Explicit Messages and/or 
Message Fragments is examined. If the Destination MAC ID is specified in the Connection ID 
(CAN Identifier Field), then the Source MAC ID of the other end-point must be specified in the 
Message Header. If the Source MAC ID is specified in the Connection ID, then the receiving 
module’s MAC ID must be specified in the Message Header. If either of these checks fail, then the 
Inactivity/Watchdog Timer IS NOT reset and the message/message fragment is discarded. 


Important: The Receive_Data event is only delivered to an Explicit Messaging Connection 
when a message who’s Connection ID matches the consumed_connection_id attribute is 
received. If a message is received whose connection id does not match any Established 
Connection Object’s consumed_connection_id attribute, then the message is discarded. 


If an implementation detects that it does not support an Explicit Messaging Service indicated in 
Table 3-4.22, then an Error Response specifying Service Not Supported (General Status Code 
08) is returned. 


— 3-49 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Vol. 1: Common Industrial Protocol Specification, Chapter 3: Communication Object Classes 


3-4.8 


Connection Object Attribute Access Rules 


During the configuration of a Connection instance using the Set_Attribute service, a module 
must perform value checks of each separate attribute when is modified. If an error is detected, 
then an Error Response is returned. The discovery of an error DOES NOT cause the deletion of 
the Connection instance. 


Important: If the produced_connection_id and/or consumed_connection_id attributes contain 
a non-default value upon reception of the Apply Request, then the related portion of the 
initial_comm_characteristics attribute is ignored and the ID value is validated and used. 


The following series of tables indicates when an attribute can be read or written via a Get 
and/or Set operation based on the Connection’s state and instance_type. 


Important: If a request to Get/Set a supported attribute is received but the current state and/or 
instance_type of Connection dictates that the requested access is invalid, then the returned error 
status indicates: The object cannot perform the requested service in its current mode/state 
(General Status Code value = 0Chex - see Appendix B for more information on status codes). 


Table 3-4.23 I/O Connection Object Attribute Access 


I/O Connection State 


Waiting for 
Attribute Non-Existent | Configuring Connection ID Established | Timed Out 


State Not available | Get Only Get Only Get Only Get Only 
instance_type Not available | Get Only Get Only Get Only Get Only 


transport Class_trigger 
produced_connection_id 
consumed_connection_id 
initial_comm_characteristics 
produced_connection_size 
consumed_connection_size 
expected_packet_rate’ 
watchdog_timeout_action 


produced_connection_ 
path_length 


produced_connection_path 


consumed_connection_ 
path_length 


consumed_connection_path 


production_inhibit_time 


Not available Get Only Get Only Get Only 


Not available 


Not available |Get Only Get Only Get Only Get Only 


Not available Get Only Get Only Get Only 


Not available | Get Only Get Only Get Only Get Only 


Not available Get Only Get Only Get Only 
Not available Get Only Get/Set 


connection_timeout_multiplier | Not available Get Only Get/Set 


Connection_binding_list 


Not available | Get Only Get Only Get Only Get Only 
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I/O Connection State 


Waiting for 
Attribute Non-Existent | Configuring Connection ID Established | Timed Out 


1 When a Connection Object is in the Established state, any modifications to the 
expected_packet_rate or connection_timeout_multiplier attributes have immediate effect on the 
Inactivity/Watchdog Timer. The following steps are performed by a Connection Object in the 
Established state when a request is received to modify the expected_packet_rate or 
connection_timeout_multiplier attribute: 

e the current Inactivity/Watchdog Timer is canceled 
e anew Inactivity/Watchdog Timer is activated based on the new value in the 
expected_packet_rate or connection_timeout_multiplier attribute. 


Table 3-4.24 CIP Bridged Connection Object Attribute Access 


Default CIP Bridged Connection State 
Attribute Value’ Non-Existent Configuring Established Closing 
state 1 Not Available Get Only Get Only Get Only 
instance_type 2 Not Available Get Only Get Only Get Only 
transportClass_trigger From Not Available Get Only Get Only Get Only 
service 
produced_connection_id From Not Available Get Only Get Only Get Only 
service 
consumed_connection_id From Not Available Get Only Get Only Get Only 
service 
initial_comm_characteristics From Not Available Get Only Get Only Get Only 
service 
produced_connection_size From Not Available Get Only Get Only Get Only 
service 
consumed_connection_size From Not Available Get Only Get Only Get Only 
service 
expected_packet_rate From Not Available Get Only Get Only Get Only 
service 
watchdog_timeout_action 1 Not Available Get Only Get Only Get Only 
produced_connection_path_ From Not Available Get Only Get Only Get Only 
length service 
produced_connection_path From Not Available Get Only Get Only Get Only 
service 
consumed_connection_path_le | From Not Available Get Only Get Only Get Only 
ngth service 
consumed_connection_path From Not Available Get Only Get Only Get Only 
service 
production_inhibit_time From Not Available Get Only Get Only Get Only 
service 
Connection_timeout_multiplier | From Not Available Get Only Get Only Get Only 
service 
Connection_binding_list Empty Not Available Get Only Get Only Get Only 


1 The default value is either the value indicated or is set based on one of the parameters of the Forward Open 
service received by the Connection Manager object. 
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Table 3-4.25 Explicit Messaging Connection Object Attribute Access 


Explicit Messaging Connection State 


Attribute Non-Existent Established/Deferred Delete 


State 

instance_type 
transportClass_trigger 
produced_connection_id 
consumed_connection_id 
initial_comm_characteristics 
produced_connection_size 
consumed_connection_size 
expected_packet_rate # 
watchdog_timeout_action 


produced_connection_ 
path_length 


produced_comnection_path 


consumed_connection_ 
path_length 


consumed_connection_path 
production_inhibit_time 
connection_timeout_multiplier 


Connection_binding_list 


ot available Get Only 
Get Only 
Get Only 
Get Only 
Get Only 
Get Only 
Get Only 
Get Only 
Get/Set' 

Get/Set 


Get Only 


ot available 
ot available 
ot available 
ot available 
ot available 
ot available 
ot available 
ot available 
ot available 


ot available 


ot available Get Only 


ot available Get Only 


ot available Get Only 
Get Only 
Get/Set * 


Get Only 


ot available 


Not available 


Z 


ot available 


1 When a Connection Object is in the Established state, any modifications to the expected_packet_rate 
or connection_timeout_multiplier attributes have immediate effect on the Inactivity/Watchdog Timer. 
The following steps are performed by a Connection Object in the Established state when a request is 
received to modify the expected_packet_rate or connection_timeout_multiplier attribute: 

e the current Inactivity/Watchdog Timer is canceled 
e anew Inactivity/Watchdog Timer is activated based on the new value in the 
expected_packet_rate or connection_timeout_multiplier attribute. 
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3-5 


3-5.1 


3-5.2 


3-5.2.1 


Connection Manager Object Class Definition 
Class Code: 06 hex 


The Connection Manager Class allocates and manages the internal resources associated with 
both I/O and Explicit Messaging Connections. The specific instance generated by the 
Connection Manager Class is referred to as a Connection Instance or a Connection Object. 


Connection Manager Object Class Attributes 


The Connection Manager Class attributes are defined below in Table 3-5.1. 


Table 3-5.1 Connection Manager Class Attributes 


Attribute Need In Access | Attribute | Data Type Attribute Semantics of 
ID Implementation Rule Name Description Values 
1 thru 7 These class attributes are optional and are described in Chapter 4 of this specification. 


Connection Manager Object Class Services 


The Connection Manager Class supports the following CIP Common Services: 


Table 3-5.2 Connection Manager Class Services 


Service Need In Service Name Service Description 
Code Implementation 


O1lhex Optional Get_Attributes_All | Returns the contents of all attributes of the class. 


OEhex Used to read a Connection Manager Class attribute value. 
Single 


1 This service is Required if any of the Connection Manager Class Attributes are supported and the 
Get_Attribute_All service is not supported. 


Class Level Get_Attributes_All Response 


At the Class level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows: 


Table 3-5.3 Get_Attributes_All Response Data 


Byte Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
Revision (low byte) Default = 1 
Revision (high byte) Default = 0 

Max Instance (low byte) Default = 1 

Max Instance (high byte) Default = 0 

Max ID Number of Class Attributes (low byte) Default = 0 

Max ID Number of Class Attributes (high byte) Default = 0 

Max ID Number of Instance Attributes (low byte) Default = 0 


NP OD] ay R] Ww] Nl rR] oO 


Max ID Number of Instance Attributes (high byte) Default = 0 


Important: Insert default values for all unsupported attributes. 
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3-5.3 Connection Manager Object Instance Attributes 


The following list provides a summary of the Connection Manager Instance attributes and their 
associated data types. 


Table 3-5.4 Connection Manager Object Instance Attributes 


Attr Need In | Access} NV | Attribute Name | Data Type Description of Attribute Semantics 
ID Implem | Rule 
1 Optional Set V_ | Open Requests UINT Number of Forward Open 
service requests received. 
2 Optional Set V_ | Open Format UINT Number of Forward Open 
Rejects service requests which were 
rejected due to bad format. 
3 Optional Set V_ | Open Resource 
Rejects 
4 Optional Set V_ | Open Other 
Rejects 
than bad format or lack of 
resources. 


5 Optional Set V_ | Close Requests UINT Number of Forward Close 
service requests received. 
6 Optional Set V_ | Close Format UINT Number of Forward Close 
Requests service requests which were 
7 Close Other 


rejected due to bad format. 
Set 
Requests 
| 


9 Optional Get Connection Entry 
List 


UINT 


Number of Forward Open 
service requests which were 
rejected due to lack of 


resources. 


UINT Number of Forward Open 
service requests which were 


rejected for reasons other 


Number of Forward Close 
service requests which were 
rejected for reasons other 
than bad format. 


Vv UINT 
V Total number of connection 
timeouts that have occurred 


in connections controlled by 
this Connection Manager 


STRUCT of | List of Connections 


Connection UINT 


Timeouts 


If the Connection Object 
(Class Code 0x05) is 
supported, the index value 
into the ConnOpenBits 
array is the Connection 
Instance number minus one 
(the first entry in the array, 
index value 0, is for 
Connection Instance 1). 


Number of connection Number of bits in the 
entries. This attribute, ConnOpenBits attribute. 
divided by 8 and rounded up 


NumConnEntries UINT 


for any remainder, gives the 
length of the array (in bytes) 
of the ConnOpenBits field 
of this structure. 
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Attr Need In | Access} NV | Attribute Name | Data Type Description of Attribute Semantics 
ID Implem | Rule 


ConnOpenBits ARRAY of | List of connection data 0 = Connection Instance is 
BOOL which may be individually Non-Existent. 
queried by the Get/Search 1 = Connection Instance is 
Connection Data Services. Existent. Query for more 
Each bit represents a possible | information. 
connection. 
10 Reserved/Obsolete 


11 | Optional Get V_ |CPU_Utilization' | UINT CPU Utilization in tenths of | Range of 0 - 1000 

a percent. representing 0 to 100%. 
12 | Optional Get V_ | MaxBuffSize' UDINT Amount of buffer space Size in bytes 

originally available. 


13 | Optional Get V_ | BufSize UDINT Amount of buffer space Size in bytes 
Remaining" available at this time. 


1 The meaning of, and method of calculating, these values are vendor specific. 
3-5.4 Connection Manager Object Instance Common Services 
The Connection Manager Object Instance supports the following CIP Common services: 


Table 3-5.5 Connection Manager Object Instance Common Services 


Service Need In Service Name Service Description 
Code | Implementation 


Olhex | Optional Get_Attributes_All Returns the contents of all attributes of the class. 


OEhex Get_Attribute_Single | Used to read a Connection Manager Object instance attribute. 


10hex Set_Attribute_Single | Used to modify a Connection Manager Object instance 
attribute. 


1 This service is Required if any of the Connection Manager Instance Attributes are supported and the 
Get_Attribute_All service is not supported. 


3-5.4.1 Instance Level Get_Attributes_All Response 


At the Instance level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows. This service shall only return 
values of supported attributes. Therefore, a device can only return values up to the last 
consecutive supported attribute starting from the first attribute (Attribute 1). Values from any 
attributes supported beyond these must be acquired via a Get_Attribute_Single service. 


Table 3-5.6 Instance Level Get_Attributes_All Service Data 


Byte Bit 7 Bit 6 Bit5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
Open Requests (low byte) 
Open Requests (high byte) 
Open Format Rejects (low byte) 
Open Format Rejects (high byte) 
Open Resource Rejects (low byte) 
Open Resource Rejects (high byte) 
Open Other Rejects (low byte) 
Open Other Rejects (high byte) 


COYN] OD] UTR] WwW] NMyTrRto 


Close Requests (low byte) 
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3-5.5 


Byte Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
9 Close Requests (high byte) 


10 Close Format Rejects (low byte) 

11 Close Format Rejects (high byte) 

12 Close Other Rejects (low byte) 

13 Close Other Rejects (high byte) 

14 Connection Timeouts (low byte) 

15 Connection Timeouts (high byte) 

16 Connection Entry List - NumConnEntries (low byte) 

17 Connection Entry List - NumConnEntries (high byte) 

18 Connection Entry List - ConnOpenBits (up to first 8 BOOLs) 

19 Connection Entry List - ConnOpenBits (up to second 8 BOOLs, if applicable) 
n Connection Entry List — ConnOpenBits (up to n" 8 BOOLs, if applicable) 
n+1 CPU_Utilization (low byte) 

n+2 CPU_Utilization (high byte) 

n+3 MaxBuffSize (low byte) 

n+4 MaxBuffSize 

n+5 MaxBuffSize 

n+6 MaxBuffSize (high byte) 

n+7 BufSize Remaining (low byte) 

n+8 BufSize Remaining 

n+9 BufSize Remaining 


n+10 BufSize Remaining (high byte) 


Important: There are no default values for unsupported attributes; all values returned are for 
supported attributes. 


Connection Manager Object Instance Object Specific Services 


The Connection Manager Object Instance supports the following Object Specific services: 


Table 3-5.7 Connection Manager Object Instance Object Specific Services 


Service Need In Service Name Service Description 
Code | Implementation 


4E hex Conditional Forward_Close Closes a connection 


52hex Unconnected Send Service. Only originating devices and 
devices that route between links need to implement 

54hex Opens a connection, maximum data size is 511 bytes 

S6hex For diagnostics of a connection 

57 hex For diagnostics of a connection 

5Anex Determine the owner of a redundant connection 

5Bhex Opens a connection, maximum data size is 65535 bytes 


— 3-56 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Vol. 1: Common Industrial Protocol Specification, Chapter 3: Communication Object Classes 


3-5.5.1 


3-5.5.1.1 


Connection Manager Object Specific Service Parameters 


The object specific services of the Connection Manager Object share many of the same service 
parameters. These parameters are defined in this section and referenced in the object specific 
service definitions. 


The Forward_Open, Large_Forward_Open and Forward_Close services shall be sent using the 
UCMM or an unbridged (local) explicit messaging connection only. They shall not be sent 
over a bridged explicit messaging connection. This restriction is required since each node on a 
bridged connection needs to receive and process these services. On subnets which support 
UCMM messaging, the recipient (either a target or an intermediate node) shall support these 
services using the UCMM and, in addition, may support these services over a local explicit 
messaging connection. On subnets which do not support UCMM messaging, these services 
shall be sent using a local explicit messaging connection. See Chapter 10 for more details on 
bridging and routing. 


Network Connection Parameters 


The Network Connection Parameters in the Forward_Open shall be provided as a single 16-bit 
word that contains the fields in the following figure: 


Table 3-5.8 Network Connection Parameters for Forward_Open 


15 14 13 12 11 | 10 9 B | 71 je | es | 4 is | 2 | wy |e 
Redundant | Connection | Reserved | Priority Fixed / Connection Size (in bytes) 
Owner Type Variable 


The Network Connection Parameters in the Large_Forward_Open shall be provided as a single 
32-bit word that contains the fields in the following figure: 


Table 3-5.9 Network Connection Parameters for Large_Forward_Open 


31 30 29 28 27 | 26 25 24-16 15-0 
Redundant | Connection | Reserved | Priority Fixed / Reserved Connection Size (in bytes) 
Owner Type Variable 


e Connection Size: The maximum size, in bytes, of the data for each direction (where 
applicable) of the connection. For a variable sized connection, the size shall be the 
maximum size of the buffer for any transfer. The actual size of the transfer for a variable 
connection shall be equal to or less than the size specified for the network connection. The 
maximum buffer size shall be dependent on the links that the connection traverses. The 
connection size includes the sequence count and the 32-bit real time header, if present. 

e Fixed/ Variable: With a fixed size connection, the amount of data on each transmission 
shall be the size specified in the Connection Size parameter. With a variable size 
connection, the amount of data on each transmission may be a variable size, up to the size 
specified in the Connection Size parameter. 

0 = Fixed 
1 = Variable 

e Priority: The priority shall be one of: 
00 = Low Priority 
01 = High Priority 
10 = Scheduled 
11 = Urgent 
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e Connection Type: 
00 = Null (may be used to reconfigure a connection) 
01 = Multicast 
10 = Point to Point 
11 = Reserved 
e Redundant Owner 
The redundant owner bit in the OST direction shall be set (= 1) to indicate that more than 
one owner may be permitted to make a connection simultaneously. The bit shall be clear 
(= 0) to indicate an exclusive-owner, input only or listen-only connection. 
e Reserved fields shall be set to zero 


Packet Interval 


The object specific services of the Connection Manager Object share many of the same service 
parameters. These parameters are defined in this section and referenced in the object specific 
service definitions. 


Requested packet interval (RPI) 


The requested packet interval shall be the requested time between packets in microseconds. 
The format of the RPI shall be a 32-bit integer in microseconds. 


Actual packet interval (API) 


The actual packet interval shall be the actual time between packets in microseconds. The 
format of the API shall be a 32-bit integer in microseconds. 


Usage 


The requested packet interval shall be the time between packets requested by the receiving 
device. The value shall be used to allocate bandwidth at each of the producing nodes. The 
allocation of bandwidth may have to be adjusted when the actual packet rate or actual packet 
interval is returned, since it is possible for the two values to differ. The path time-out value at 
each of the intermediate and target nodes shall also be set to the connection time-out multiplier 
times the API. The RPI is therefore required for all connections. 


Scheduled priority 


For scheduled priority, the RPI shall be the packet rate of the repetitive data. On links that 
support bandwidth allocation, bandwidth shall be reserved for this packet. For scheduled 
priority, the data shall also be restricted to the specified packet rate, which means that if data 
arrives at an intermediate node faster than the specified packet rate, the node shall filter the 
packets to the specified rate. Since each node’s scheduled priority update rate is in discrete 
quanta, the Actual Packet Interval (API) may be smaller (more rapid) than the RPI. The path 
time-out value shall be set to the Connection Time-out multiplier times the API. 
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High priority 


For high priority, the RPI shall be used to set the path time-out in the intermediate and target 
nodes. The RPI shall therefore be set to the slowest packet rate expected, which shall preclude 
having the connection close due to a path time-out. The longer the path time-out, the longer 
the time required to reclaim resources in the intermediate nodes as a result of faults in the 
network. Since the high priority is not quantized at any of the nodes, the API shall equal the 
RPI. To maintain consistency, however, the time-out value shall again be set to the Connection 
Time-out multiplier times the API. 


Low priority 


For low priority, the RPI shall be used to set the path time-out in the intermediate and target 
nodes. The RPI shall therefore be set to the slowest packet rate expected, which shall preclude 
having the connection close due to a path time-out. The longer the path time-out, the longer 
the time required to reclaim resources in the intermediate nodes as a result of faults in the 
network. Since the low priority is not quantized at any of the nodes, the API shall equal the 
RPI. To maintain consistency, however, the time-out value shall again be set to the Connection 
Time-out multiplier times the API. 


Connection Timing 


The Priority/Time_tick parameter determines the priority of the unconnected message and the 
time duration of a ‘tick’ (Tick Time) specified in the Time-out_ticks parameter. The bit fields 
are: 


Table 3-5.10 Priority/Time_tick Bit Definition 


7 6 5 4 3 2 1 0 
Priority 
Reserved 0 = Normal Tick Time 


1 = Reserved 


The Reserved and Priority fields shall be set to zero (0). The tick time shall be used in 
conjunction with the Time-out_ticks parameter value to determine the total time out value. The 
following formula is used: 


gtime_tick ¥ Time_out_tick 


Actual Time Out value = 
If the tick time is 0000 (1 ms.), a Time-out_ticks value of 5 would translate into 5 ms. If the 
tick time is 0010 (4 ms.), a Time-out_ticks value of 5 would translate into 20 ms. The Tick 
Time value is enumerated in the following table. 
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Table 3-5.11 Time Tick Value Enumeration 


Time Tick Value Enumeration 


Tick Time Time per Tick Max Time 
(binary) 

0000 1ms 255 ms 
0001 2 510 
0010 4 1020 
0011 8 2040 
0100 16 4080 
0101 32 8160 
0110 64 16,320 
0111 128 32,640 
1000 256 65,280 
1001 512 130,560 
1010 1024 261,120 
1011 2048 522,240 
1100 4096 1,044,480 
1101 8192 2,088,960 
1110 16,384 4,177,920 
1111 32, 768 8, 355, 840 ms 


Time-out_ticks 


The Time-out ticks parameter shall be used to specify the amount of time the originating 
application shall wait for the transaction to be completed. When used with the Time Tick 
portion of the Priority/Time_tick field, a total timeout value can be calculated. 


Timeout Algorithm 


The Priority/Time_tick and Time-out ticks parameters are used to convey timeout information 
as the request flows through interconnecting devices. The originator states how long it will 
wait for a response (total round trip time), and each intermediate device (e.g. CIP Router) 
subtracts twice the actual amount of time between the reception of the packet and when 
processing of the packet is actually started (e.g. internal queuing/processing times, etc.) when 
forwarding the unconnected message along. If a CIP Router cannot determine specifically how 
much time to subtract, it shall subtract 512 milliseconds. Each intermediate device shall use 
this adjusted value as a timer for the resources used to manage the unconnected message and 
also to check to see if a timeout is imminent before forwarding the message. If a timeout is 
imminent, then the intermediate device returns an error response rather than just letting the 
originator timeout. Also, when an intermediate device times out, an error response is returned. 
In both cases all resources associated with that unconnected message are released. This 
facilitates the ability to know how far along the route the packet progressed before the timeout 
actually occurred, and also results in intermediate nodes not leaving resources assigned to a 
transaction that has already timed out. 
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3-5.5.1.5 


3-5.5.1.6 


3-5.5.1.7 


3-5.5.1.8 


Connection Serial Number 


The connection serial number shall be a unique 16-bit value selected by the connection 
manager at the originator of the connection. The originator shall make sure that the 16-bit 
value is unique for the device. There shall be no other significance placed on the number by 
any other nodes in the connection path. The connection serial numbers shall be unique but do 
not have to be sequential. For example, an operator interface may have a large number of 
connections open at the same time, each with a unique number. The same values could be 
repeated at other operator interface stations. A possible implementation would be to have a 
connection list which points to the descriptor for each connection, and the connection serial 
number could be the index into the table. 


Connection Timeout Multiplier 


The Connection Timeout Multiplier specifies the multiplier applied to the RPI to obtain the 
connection timeout value. Devices shall stop transmitting on a connection whenever the 
connection times out even if the pending close has been sent. The multiplier shall be as 
represented by the following table: 


Table 3-5.12 Connection Timeout Multiplier Values 


Value Multiplier 
0 x4 
1 x8 
2 x16 
3 x32 
4 x64 
5 x128 
6 x256 
7 x512 
8 - 255 Reserved 
Vendor ID 


The Vendor ID utilized in conjunction with the Connection Manager is a reference to the 
Identity object instance #1 attribute #1 (Vendor ID). 


Originator Serial Number 
The Serial Number utilized in conjunction with the Connection Manager is a reference to the 
Identity object instance #1 attribute #6 (Serial Number). 


Connection Number 


The connection number shall be a 16-bit value that is assigned by the connection manager 
when a connection is opened. This value allows other nodes to obtain connection data from the 
connection manager. This number shall not be confused with the Connection Serial Number. 
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3-5.5.1.9 


3-5.5.1.10 


Connection Path Size 


The connection path size shall be the length of the connection path in 16-bit words. The length 
of the connection path varies during the connection process, since each node in the connection 
path removes the current port segment and forwards only the remaining path segments to the 
next node. 


Appendix C, sections C-1.3 and C-1.4 specify the components of a connection path and 
sections C-1.5 and C-1.6 specify the hierarchy of a connection path. 


When a configuration data segment is included in the connection path the configuration data 
segment shall follow the applications path(s). 


Connection Path 


The connection path parameter shall contain one or more encoded paths as required by a 
combination of the service and the value of other parameters within the service data. The 
format of the path(s) shall follow that as defined by the Message Router Object (Path). The 
first part of the connection path shall contain routing information, which may include port, 
network, and electronic key segments. Also, depending on the O2T_connection_parameters 
and T2O_connection_parameters fields and the presence of a data segment, one or more 
encoded application paths shall be specified. In general, the application paths are in the order 
of Configuration path, Consumption path, and Production path. However, a single encoded 
path can be used when configuration, consumption, and/or production use the same path. The 
following table shows the valid combinations and the implied meaning of the application paths. 
The application paths are relative to the target node. 
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Table 3-5.13 Encoded Application Path Ordering 


Network Connection Number of Encoded Application Paths 
Parameters 
O->T T->O Data 1 72 3 
Connection | Connection Segment 
Type Type Present 
Null Null Yes Path is for First path is for First path is for 
Configuration. Configuration, Configuration, 
second path is second and third 
ignored paths are ignored 
No Invalid Invalid Invalid 
Not Null Null Yes Path is for First path is for Invalid 
Configuration and Configuration, 
Consumption. second path is for 
Consumption. 
No Path is for Invalid Invalid 
Consumption. 
Null Not Null Yes Path is for First path is for Invalid 
Configuration and Configuration, 
Production. second path is for 
Production. 
No Path is for Invalid Invalid 
Production. 
Not Null Not Null Yes Path is for First path is for First path is for 
Configuration, Configuration, Configuration, 
Consumption and second path is for second path is for 
Production. Consumption and Consumption, third 
Production path is for 
Production 
No Path is for First path is for First path is 
Consumption and Consumption, ignored, second 
Production. second path is for path is for 
Production. Consumption, third 
path is for 
Production 


Figure 3-5.1 Device Diagram Showing Use of Connection Path Example in Table 3-5.14 
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Table 3-5.14 Connection Path Example Showing Logical Segments 


Segment Groups Segments Description 
Routing 02 03 Route out port 2 to MAC ID 03 
Information 34 04 Key segment 
FF FF Vendor 
0C 00 Product Type 
21 00 Product Code 
8101 Major revision 1, Minor Revision 1, compatible keying 
The routing information may continue for additional routers 
01 04 Route out port 1 (backplane) to slot 4 
43 xx Production inhibit segment 
Application Paths | 20 04 Assembly object class 
24 03 Instance 3 for configuration 


2C 01 Optional O->T Connection point, specified if O->T connection type 
is not NULL 


2C 02 Optional O->T Connection point, specified if O->T connection type 
is not NULL 


80 01 Data Segment 


00 01 Configuration Data 


This example includes 3 application paths, 20 04 24 03 is the configuration path, 20 04 2C 01 
is the O->T path and 20 04 2C 02 is the T->O path (see Table 3-5.14). 


Figure 3-5.2 Device Diagram Showing Use of Connection Path Example in Table 3-5.15. 
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Table 3-5.15 Connection Path Example Showing a Symbolic Segment 


Segment Groups Segment Description 
Routing 02 03 Route out port 2 to MAC ID 03 
Information 34 04 Key segment 


FF FF Vendor 

0C 00 Product Type 

21 00 Product Code 

0101 Major revision 1, Minor Revision 1, exact match 


The routing information may continue for additional 
routers 


01 04 Route out port 1 (backplane) to slot 4 
Application Paths 91 04 4 byte Symbol segment 

74 61 ta 

67 31 gl 


This example includes one application path, a symbolic “tag1”. At least one of the O->T and 
T->O network parameters connection types must not be NULL for this connection path to be 
valid (because there is no data segment present). If both the O->T and T->O network 
parameters connection types are not NULL then the both O->T and T->O application paths are 
symbolic “tag1” (see Table 3-5.15). 


3-5.5.1.10.1 Connection Path Compression 


When a Data Segment is present (and thus a Configuration Path), the Connection Path 
encoding can be compressed if all of the following are true: 


e A Data Segment is present 

e The Configuration Path consists of Class and Instance only 

e There exists only one target Class for all encoded paths (Configuration and I/O) 
e The target Class is not the Assembly Object. 

e The encoded target I/O Connection Path(s) contain Connection Points 


The compression consists of eliminating the need to replicate the instance value for each of the 
two or three paths. The Class and Instance values are applied to the Configuration Path, and 
the one or two Connection Points that follow are applied to the I/O Connection Path(s). 


An encoded path with the contents 20 ww 24 xx 2C yy 2C zz followed by a Data Segment is 
decoded as follows (given that ww does not equal 04): 


e 20 ww 24 xx Configuration Path (meaning of the Data Segment is defined by the object) 
e 20 ww 24 xx 2C yy Consuming I/O Path 
e 20 ww 24 xx 2C zz Producing I/O Path 
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3-5.5.1.10.2 | Assumed Assembly Object Attribute 


3-5.5.1.11 


3-5.5.1.12 


3-5.5.2 


When the Connection Path parameter finds a Configuration or I/O path consisting of an 
instance of the Assembly object (Class Code 4) without an attribute, the Data attribute 
(Attribute 3) is assumed. 


An encoded path with the contents 20 04 24 xx 24 yy 24 zz followed by a Data Segment is 
decoded as follows: 


e 20 04 24 xx 30 03 Configuration Path 
e = 20 04 24 yy 30 03 Consuming I/O Path 
e = 20 04 24 zz 30 03 Producing I/O Path 


Network Connection ID 


The Network Connection ID shall be link specific and shall not be related to the connection 
serial number, which is connection specific and the same over all the links. The fields of the 
Network Connection ID shall be used to set the screening mechanism for the specified link. 
The Network Connection ID is either a CIP Produced Connection ID or CIP Consumed 
Connection ID. 


A multicast CID shall not be reused until all connections associated with the CID have been 
closed or timed out. 


Transport Class and Trigger 


The transport class and trigger specify the type of transport required for the connection. This 
information shall not be used by the connection manager but passed on to the application. The 
application shall determine if the transport type is supported and if an instance of the required 
transport is available. See the transportClass trigger attribute of the Connection Object for the 
details of this parameter. 


Forward Open and Large_Forward_Open 


The Forward Open Service (Service Code = 54;,.x) and Large_Forward_Open service (Service 
Code = 5Bnrex) are used to establish a Connection with a Target Device’. These services result in 
local connection establishment on each link along the path. The Large_Forward_Open service 
differs from the Forward_Open service only in the maximum size connection that can be 
established. This difference is evidenced in the data type and bit-field assignments of the O to T 
and T to O Network Connection parameters. All references to the Forward_Open service in this 
specification shall apply to both services. 


The Forward Open request sets up network, transport, and application connections. An 
application connection consists of a single transport connection, and one or two network 
connections that are in turn comprised of one or more multiple link connections. Each port 
segment in the connection path uses a link connection. The Forward_Open service between 
two devices builds one or two link connections as specified by the network connection 
parameter and the requested packet intervals (RPI). Since up to two network connections can 
be required for a single transport connection, they are differentiated by the O->T and T->O 
designations; O->T means originator to target, and T->O means target to originator. 


' The processing of a single Forward_Open service may result in the creation of multiple active connection object 


instances. 
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A connection established to the Message Router object of the target (based on the Connection 
Path parameter in the Forward_Open request) results in an Explicit Messaging type connection. 
The format of the data sent on this connection uses the Message Router Request/Response 
Format as defined in Chapter 2-4 of this specification. Connections established to any other 
application object result in an I/O type connection. See the Connection Object attribute 2 
(Instance Type). 


Table 3-5.16 Forward_Open / Large_Forward_Open Request 


Parameter Name Data Type Description 
Priority/Time_tick BYTE Used to calculate request timeout information. See 3-5.5.1.3. 
Time-out_ticks SINT Used to calculate request timeout information. See 3-5.5.1.3. 


O->T Network Connection ID UDINT Network Connection ID to be used for the local link, originator to 
target. This is the originator’s CIP Produced Connection ID. 


Transport Type/Trigger BYTE See Object Specific Service Parameters above. 
Connection_Path_ Size USINT The number of 16 bit words in the Connection_Path field. 


Connection_Path Padded Indicates the route to the Remote Target Device. 
EPATH 


1 The data type of this parameter is a WORD for the Forward_Open service, and a DWORD for the 
Large_Forward_Open service. 


| Data Type 
[BYTE 
T->O Network Connection ID Network Connection ID to be used for the local link, target to 
originator. This is the originator’s CIP Consumed Connection ID. 
Connection Serial Number See Object Specific Service Parameters above. 
Originator Vendor ID Vendor ID of the originating node. 
Originator Serial Number Serial Number of the originating node. 
Connection Timeout Multiplier See Object Specific Service Parameters above. 
Reserved Reserved 
O->T RPI Originator to Target requested packet rate, in microseconds. 
O->T Network Connection See Object Specific Service Parameters above. 
Parameters DWORD ! 
T->O RPI Target to Originator requested packet rate, in microseconds. 
T->O Network Connection See Object Specific Service Parameters above. 
Parameters DWORD ! 
[BYTE 
|USINT 


Success shall be returned when the connection requested has been established from this point 
forward in the path. This reply also shall indicate the connection serial number and the actual 
packet rate of the connection. Once the successful reply has been received, the connection 
shall be open from this point forward in the path. Targets shall wait at least 10 seconds after 
sending a successful response for the first packet on a connection. 
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Table 3-5.17 Successful Forward_Open / Large_Forward_Open Response 


Parameter Name Description 

O->T Network Connection ID UDINT Network Connection ID to be used for the local link, originator to 
target. If chosen by the originator, then the value is echoed back. 
This is the target’s CIP Consumed Connection ID. 

T->O Network Connection ID UDINT Network Connection ID to be used for the local link, target to 
originator. If chosen by the originator, then the value is echoed back. 
This is the target’s CIP Produced Connection ID. 

Connection Serial Number UINT Returns same value received in the Request packet. 

Originator Vendor ID UINT Returns same value received in the Request packet. 

Originator Serial Number UDINT Returns same value received in the Request packet. 

O->T API UDINT Actual packet rate, originator to target. A router shall use the lesser 
of this value and the T->O API for the expected_packet_rate of the 
connection. 

T->O API UDINT Actual packet rate, target to originator. A router shall use the lesser 
of this value and the O->T API for the expected_packet_rate of the 
connection. 

Application Reply Size USINT Number of 16 bit words in the Application Reply field. 

Reserved USINT Reserved 

Application Reply Array of Application specific data 

Byte 


The following format shall be used for all Forward_Open failures. The requested connection 
shall not be established, and the object specific status words shall contain information about the 
reason for the failure. The remaining_path_size shall contain the length of the path at the point 
the connection request failed. 


In the failure response, the remaining remaining_path_size shall be the “pre-stripped” size. 
This shall be the size of the path when the node first receives the request and has not yet started 
processing it. A target node may return either the “pre-stripped” size or O for the remaining 
remaining_path_size. 


A duplicate Forward_Open service shall be defined as a Forward_Open service whose 
vendor_ID, connection_serial_number, and originator_serial_number match an existing 
connection’s parameters. If the duplicate Forward_Open service is a null Forward_Open 
service (defined as the connection type in both the O->T and T->O network connection 
parameter fields are NULL), then the Forward_Open service shall be forwarded to the 
application for further processing. Null Forward_Open requests may be used to reconfigure the 
connection. The Connection Manager in the intermediate nodes need not allocate additional 
resources for a duplicate Forward_Open request since the resources have already been 
allocated. If the duplicate Forward_Open request is not NULL, then a general status = 0x01, 
extended status = 0x0100 shall be returned. 
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3-5.5.3 


Table 3-5.18 Unsuccessful Forward_Open / Large_Forward_Open Response 


Parameter Name Data Type Description 
Connection Serial Number | UINT Returns same value received in the Request packet. 
Originator Vendor ID UINT Returns same value received in the Request packet. 
Originator Serial Number UDINT Returns same value received in the Request packet. 


Remaining Path Size USINT This field is only present with routing type errors and indicates the 
number of words in the original route path (Connection_Path 
parameter of the Forward_Open Request) as seen by the router that 
detects the error. 


Reserved USINT Shall be set to zero. 


Either a target device or an intermediate router shall return an Invalid Connection Size 
extended error code, along with the maximum connection size supported additional status 
word, if the connection size requested is not supported while processing a Large 
Forward_Open request. 


The suggested originator behavior in the duplicate forward open case should be to either close 
and re-establish the connection or wait for the connection to time-out and then establish the 
connection again. It shall be recognised that in the latter case, it shall take the connection 

60 seconds (first data time-out) to time-out before the connection can be re-established. 


Forward_Close 


The Forward_Close Service (Service Code = 4E;,x) is used to close a connection with a Target 
Device (and all other nodes in the connection path). The Forward_Close request shall remove a 
connection from all the nodes participating in the original connection. The Forward_Close 
shall be sent between Connection Managers as specified in the connection_path. The 
Forward_Close request shall cause all resources in all nodes participating in the connection to 
be deallocated, including connection IDs, bandwidth, and internal memory buffers. 


If an intermediate node cannot find the connection that is to be closed (it may have timed out at 
the node), the Forward_Close request shall still be forwarded to downstream nodes or the target 


application. 


Table 3-5.19 Forward_Close Service Request 


Parameter Name Data Description 
Type 
Priority/Time_tick BYTE Used to calculate request timeout information. 
Time-out_ticks USINT Used to calculate request timeout information. 
Connection Serial Number UINT Connection Serial Number of established connection. 
Originator Vendor ID UINT Vendor ID of the originating node. 
Originator Serial Number UDINT Serial Number of the originating node. 
Connection_Path_Size USINT The number of 16 bit words in the Connection_Path field. 
Reserved USINT Reserved 
Connection_Path Padded Indicates the route to the Remote Target Device. 
EPATH 
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3-5.5.4 


Forward_Close service request shall be successful when a request is received whose Originator 
Vendor ID, Connection Serial Number, and Originator Serial Number match an existing 
connection’s parameters. Additional information provided by this service (ie, Connection Path) 
shall be ignored by the target. 


Success shall be returned when the connection has been deleted at the target. The originator, 
and each intermediate node along the path, closes the connection and releases resources 
associated with that connection when the success response is received. 


Table 3-5.20 Successful Forward_Close Response 


Parameter Name Data Type Description 
Connection Serial Number UINT Returns same value received in the Request packet. 
Originator Vendor ID UINT Returns same value received in the Request packet. 
Originator Serial Number UDINT Returns same value received in the Request packet. 
Application Reply Size USINT Number of 16 bit words in the Application Reply field. 
Reserved USINT Reserved 
Application Reply Array of byte Application specific data 


Table 3-5.21 Unsuccessful Forward_Close Response 


Parameter Name Data Type Description 
Connection Serial Number UINT Returns same value received in the Request packet. 
Originator Vendor ID UINT Returns same value received in the Request packet. 


Originator Serial Number UDINT Returns same value received in the Request packet. 
Remaining Path Size USINT 
Reserved USINT 


Unconnected_Send 


The Unconnected_Send service shall allow an application to send a message to a device 
without first setting up a connection. The Unconnected_Send service shall use the Connection 
Manager object in each intermediate node to forward the message and to remember the return 
path. The UCMM of each link shall be used to forward the request from Connection 
Manager to Connection Manager just as it is for the Forward_Open service; however, no 
connection shall be built. ‘The Unconnected_Send service shall be sent to the local Connection 
Manager and shall be sent between intermediate nodes. When an intermediate node removes 
the last port segment, the message shall be formatted as a UCMM message and sent to the port 
and link address of the last segment. 


NOTE: The target node never sees the Unconnected_Send service but only a standard 
message arriving via the UCMM. 
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Table 3-5.22 Unconnected_Send Service Parameters 


Messaging Request. If no additional data is to be sent with 
the Explicit Messaging Request, then this array will be 


octet 


Parameter Name Description 
Priority/Time_tick Used to calculate request timeout information. 
Time-out_ticks Used to calculate request timeout information. 
Message_Request_Size Specifies the number of bytes in the Message Request. 
Message_Request” 
Service Service code of the request. 
Request_Path_Size The number of 16 bit words in the Request_Path field (next 
element). 
Request_Path This is an array of bytes whose contents convey the path of 
EPATH the request (Class ID, Instance ID, etc.) for this transaction. 
Request_Data Array of Service specific data to be delivered in the Explicit 
= | copy 
Pad Only present if Message_Request_Size is an odd value. 
Route_Path_Size The number of 16 bit words in the Route_Path field. 
Reserved Reserved byte. Shall be set to zero (0). 
Route_Path Indicates the route to the Remote Target Device. 


1_ This is the Message Router Request Format as defined in Chapter 2. 


The Unconnected_Send reply shall be generated by the last intermediate node from the UCMM 
reply generated by the target node or by an intermediate node as the result of a UCMM time- 
out, a problem with the embedded message, or a problem with the Unconnected Service 
Request itself. The packet shall be routed from intermediate node to intermediate node using 
the information stored when the Unconnected_Send request was processed. The reply shall 
contain a header with status information about the request and a variable length reply generated 
by the target node. 


The application reply shall be the format of the Message reply from the target and shall contain 
error codes that resulted from the execution of the message by the application at the target 
node. 


The Reply Service code returned may be either the service code sent inside the 
Unconnected_Send service data or the Unconnected_Send service code. In either case, the 
upper bit is set to indicate a response. For example, if the requested service was a 
Get_Attribute_Single, then the response message may specify either 0x8E 
(Get_Attribute_Single = 0x0E) OR 0xD2 (Unconnected_Send = 0x52). This assists a router 
by: 
e Allowing it to pass the original service code response back for a message which made it to 
the target (since the Unconnected_Send does not appear at the target) 


e Not requiring it to parse the service code out of the Unconnected_Send request when a 
failure occurs in the routing. 


The Service Data associated with a successful Unconnected_Send response is: 
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Table 3-5.23 Successful Unconnected_Send Response 


Parameter Name 


Reply Service 
Reserved 
General Status 
Reserved 


Service Response 
Data 


Data 


Description 


Reply service code. 

Shall be zero 

This value is zero (0) for successful transactions. 
Shall be zero. 


This field contains the Explicit Messaging Service Data returned by the Target 
Device/Object. For example, this would contain Attribute Data in response to 
a Get_Attribute_Single request. If the Explicit Messaging response returned by 
the Target Device/Object did not contain any Service Data, then this field shall 
be empty. 


The response Service Data associated with an unsuccessful Unconnected_Send response is 


defined below. 


Table 3-5.24 Unsuccessful Unconnected_Send Response 


Parameter Name 


Reply Service 
Reserved 


General Status 


Size of Additional 
Status 


Additional Status 


Remaining Path 
Size 


U 


USINT 


Data 


Array of 


INT 


Description 


Reply service code. 
Shall be zero. 


One of the General Status codes listed in Appendix B Error Codes. If a routing 
error occurred, it shall be limited to the values specified in the Routing Error 
Values table. 


Number of 16 bit words in Additional Status array. 


When returning an error from a target which is a DeviceNet node, the 
Additional Status shall contain the 8 bit Additional Error Code from the target 
in the lower 8 bits and a zero (0) in the upper 8 bits. 


This field is only present with routing type errors and indicates the number of 
words in the original route path (Route_Path parameter of the Unconnected 
Send Request) as seen by the router that detects the error. 


In order to standardize Routing Error handling in CIP Routers, the following table presents the 
possible Routing Errors and when/why they would be returned. In each of these cases the 
Remaining Path Size parameter is present. 
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Table 3-5.25 Routing Error Values 


General Additional Usage 
Status Status 


01 0204 nex Timeout indicator. Returned under the following circumstances: 
Failure to establish an Explicit Messaging Connection. 
Timeout event occurs while waiting for an Explicit Messaging Response. 
After decreasing the timing parameters when an Unconnected Send request is 
received, the CIP Router determines that there is not enough time left to 
continue this transaction (a Requesting Device timeout is imminent). 

01 031 Lhex Invalid Port ID specified in the Route_Path field. 

01 031 2hex Invalid Node Address specified in the Route_Path field. 

01 0315hex Invalid segment type in the Route_Path field. 

02 empty Resource error. The CIP Router lacks the resources to fully process the 
Unconnected Send Request. 

04 empty Segment type error. Indicates the CIP Router experienced a parsing error 
when extracting the Explicit Messaging Request from the Unconnected Send 
Request Service Data. 


3-5.5.5 Get_Connection_Data 


This service shall return the parameters associated with a specified connection_number. The 
connection_number may be different from device to device even for the same connection. The 
connection_number corresponds to the offset into the Connection Manager attribute that 
enumerates the status of the connections. 


Table 3-5.26 Get_Connection_Data Service Request 


Parameter Name Description 
Connection Number Connection number 
Table 3-5.27 Get_Connection_Data Service Response 
Parameter Name Data Description 


3 


Connection Number 


° 
2, 


Connection State 


Originator Port 


cic 
ee 
Z\Z 
De A ieee Oe ie Oe ee | 


Target Port 


cq 
Zz 


Connection Serial Number UINT Connection Serial Number of established connection. 
Originator Vendor ID UINT Vendor ID of the originating node. 

Originator Serial Number Serial Number of the originating node. 

Originator O->T CID 

Target O->T CID 

Connection Timeout 

Multiplier 

Reserved 


Originator RPI O->T 
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3-5.5.6 


3-5.6 
3-5.6.1 


Parameter Name Data Description 
Type 

Originator API O->T 

Originator T->O CID 

Target T->O CID 

Connection Timeout 

Multiplier 

Reserved 


Originator RPI T->O 
Originator API T->O 


Search_Connection_Data 


This service shall return the parameters associated with the specified connection serial number, 
originator vendor ID and originator serial number. 


Table 3-5.28 Search_Connection_Data Service Request 


Parameter Name Data Description 
Type 
Connection Serial Number Connection Serial Number of established connection. 
Originator Vendor ID Vendor ID of the originating node. 
Originator Serial Number Serial Number of the originating node. 


The format of the Search_Connection_Data response shall be the same as the response from the 
Get_Connection_Data service. 


Connection Manager Object Instance Error Codes 


Error Code Listing 


The error codes are returned with the reply to a Connection Manager Service Request that 
resulted in an error. These error codes shall be used to help diagnose the problem with a 
Service Request. The error code shall be split into an 8 bit general status and one or more 16- 
bit words of extended status. Unless specified otherwise, only the first word of extended status 
shall be required. Additional words of extended status may be used to specify additional 
module specific debug information. All devices that originate messages shall be able to handle 
multiple words of extended status. 


The following table provides a summary of the available error codes. 
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Table 3-5.29 Connection Manager Service Request Error Codes 


General Extended Explanation and Description 
Status Status 


0x00 Service completed successfully 
0x01 0x0000 Obsolete. 
through 
Ox00FF 
0x01 0x0100 CONNECTION IN USE OR DUPLICATE FORWARD OPEN 


This extended status code shall be returned when an originator is trying to make a 
connection to a target with which the originator may have already established a 
connection (duplicate Forward_Open — see 3-5.5.2). 


0x01 0x0101 Reserved by CIP 
through 
0x0102 
0x01 0x0103 TRANSPORT CLASS AND TRIGGER COMBINATION NOT SUPPORTED 


A transport class and trigger combination has been specified which is not supported 
by the target. Routers shall not fail the connection based on the transport class and 
trigger combination. Only targets shall return this extended status code. 


0x01 0x0104 Reserved by CIP 
through 
0x0105 
0x01 0x0106 OWNERSHIP CONFLICT 


The connection cannot be established since another connection has exclusively 
allocated some of the resources required for this connection. An example of this 
would be that only one exclusive owner connection can control an output point on 
an I/O Module. If a second exclusive owner connection (or redundant owner 
connection) is attempted, this error shall be returned. This extended status code 
shall only be returned by a target node. 


0x01 0x0107 TARGET CONNECTION NOT FOUND 


This extended status code shall be returned in response to the forward_close 
request, when the connection that is to be closed is not found at the target node. 
This extended status code shall only be returned by a target node. Routers shall not 
generate this extended status code. If the specified connection is not found at the 
intermediate node, the close request shall still be forwarded using the path specified 
in the Forward_Close request. 


0x01 0x0108 INVALID NETWORK CONNECTION PARAMETER 


This extended status code shall be returned as the result of specifying a connection 
type, connection priority, redundant owner or fixed / variable that is not supported 
by the target application. Only a target node shall return this extended status code. 


0x01 0x0109 INVALID CONNECTION SIZE 


This extended status code is returned when the target or router does not support the 
specified connection size. This could occur at a target because the size does not 
match the required size for a fixed size connection. It could occur at a router if the 
requested size is too large for the specified network. 


An additional status may follow indicating the maximum connection size supported 
by the responding node. The additional status word is required when issued in 
response to the Large_Forward_Open. 
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General Extended Explanation and Description 
Status Status 
0x01 0x010A Reserved by CIP 
through 
0x010F 

0x01 0x0110 TARGET FOR CONNECTION NOT CONFIGURED 
This extended status code shall be returned when a connection is requested to a 
target application that has not been configured and the connection request does not 
contain a data segment for configuration. Only a target node shall return this 
extended status code. 
Reference section C-1.4.5 - DATA SEGMENT 

0x01 0x0111 RPI NOT SUPPORTED. 
This extended status code shall be returned if the device can not support the 
requested O->T or T->O RPI. This extended status code shall also be used if the 
connection time-out multiplier produces a time-out value that is not supported by 
the device or the production inhibit time is not valid. 

0x01 0x0112 Reserved by CIP 

0x01 0x0113 OUT OF CONNECTIONS 
Connection Manager cannot support any more connections. The maximum number 
of connections supported by the Connection Manager has already been created. 

0x01 0x0114 VENDOR ID OR PRODUCT CODE MISMATCH 
The Product Code or Vendor Id specified in the electronic key logical segment does 
not match the Product Code or Vendor Id of the target device. 

0x01 0x0115 PRODUCT TYPE MISMATCH 
The Product Type specified in the electronic key logical segment does not match the 
Product Type of the target device. 

0x01 0x0116 REVISION MISMATCH 
The major and minor revision specified in the electronic key logical segment does 
not correspond to a valid revision of the target device. 

0x01 0x0117 INVALID PRODUCED OR CONSUMED APPLICATION PATH 
The produced or consumed application path specified in the connection path does 
not correspond to a valid produced or consumed application path within the target 
application. This error could also be returned if a produced or consumed 
application path was required, but not provided by a connection request. 

0x01 0x0118 INVALID OR INCONSISTENT CONFIGURATION APPLICATION PATH 


An application path specified for the configuration data does not correspond to a 
configuration application or is inconsistent with the consumed or produced 
application paths. For example the connection path specifies float configuration 
data while the produced or consumed paths specify integer data. 
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General Extended Explanation and Description 
Status Status 


0x01 0x0119 NON-LISTEN ONLY CONNECTION NOT OPENED 


Connection request fails since there are no non-listen only connection types 
currently open. Refer to Section 3.6 for a description of application connection 


types. 


The extended status code shall be returned when an attempt is made to establish a 
listen only connection type to a target, which has no non-listen only connection 
already established. 


0x01 0x011A TARGET OBJECT OUT OF CONNECTIONS 


The maximum number of connections supported by this instance of the target object 
has been exceeded. 


For example, the Connection Manager could support 20 connections while the 
target object can only support 10 connections. On the 11th Connection Request to 
the target object, this extended status code would be used to signify that the 
maximum number of connections already exist to the target object. 


0x01 0x011B RPI IS SMALLER THAN THE PRODUCTION INHIBIT TIME 


The Target to Originator RPI is smaller than the Target to Originator Production 
Inhibit Time. 


0x01 0x011C Reserved by CIP 
through 
0x0202 


0x01 0x0203 CONNECTION TIMED OUT 


This extended status code shall occur when a client tries to send a connected 
message over a connection that has been timed-out. This extended status code shall 
only occur locally at the producing node. 


0x01 0x0204 UNCONNECTED REQUEST TIMED OUT 


The Unconnected Request Timed Out error shall occur when the UCMM times out 
before a reply is received. This may occur for an Unconnected_Send, 
Forward_Open, or Forward_Close service. This typically means that the UCMM 
has tried a link specific number of times using a link specific retry timer and has not 
received an acknowledgement or reply. This may be the result of congestion at the 
destination node or may be the result of a node not being powered up or present. 
This extended status code shall be returned by the originating node or any 
intermediate node. 


0x01 0x0205 PARAMETER ERROR IN UNCONNECTED REQUEST SERVICE 


For example, this shall be caused by a Connection Tick Time (see section 3-5.5.1.3) 
and Connection time-out combination in an Unconnected_Send, Forward_Open, or 
Forward_Close service that is not supported by an intermediate node. 


0x01 0x0206 MESSAGE TOO LARGE FOR UNCONNECTED_SEND SERVICE 


This shall be caused when the Unconnected_Send is too large to be sent out on a 
network. 


0x01 0x0207 UNCONNECTED ACKNOWLEDGE WITHOUT REPLY 
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General Extended Explanation and Description 
Status Status 
The message was sent via the unconnected message service and an acknowledge 
was received but a data response message was not received. 
0x01 0x0208 Reserved by CIP 
through 
0x0300 
0x01 0x0301 NO BUFFER MEMORY AVAILABLE 
The extended status code shall occur when insufficient connection buffer memory is 
available in the target or any router devices. Routers and target nodes shall return 
this error. 
0x01 0x0302 NETWORK BANDWIDTH NOT AVAILABLE FOR DATA 
This extended status code shall be returned by any device in the path that is a 
producer and can not allocate sufficient bandwidth for the connection on its link. 
This can occur at any node. This can only occur for connections that are specified 
as scheduled priority. 
0x01 0x0303 NO CONSUMED CONNECTION ID FILTER AVAILABLE 
Any device in the path that contains a link consumer for the connection and does 
not have an available consumed_connection_id filter available shall return this 
extended status code. 
0x01 0x0304 NOT CONFIGURED TO SEND SCHEDULED PRIORITY DATA 
If requested to make a connection that specifies scheduled priority, any device that 
is unable to send packets during the scheduled portion of the network update time 
interval shall return this extended status code. For example, on ControlNet this 
code shall be returned by a node whose MAC ID is greater than maximum 
scheduled node (SMAX). 
0x01 0x0305 SCHEDULE SIGNATURE MISMATCH 
This extended status code shall be returned when the connection scheduling 
information in the originator device is not consistent with the connection scheduling 
information on the target network. 
0x01 0x0306 SCHEDULE SIGNATURE VALIDATION NOT POSSIBLE 
This extended status code shall be returned when the connection scheduling 
information in the originator device can not be validated on the target network. For 
example, on ControlNet this code shall be returned when there is no keeper in the 
master state. 
0x01 0x0307 Reserved by CIP 
through 
0x0310 
0x01 0x0311 PORT NOT AVAILABLE 


A Port specified in a Port Segment is Not Available or does not exist. 
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General 
Status 


0x01 


Extended 
Status 


0x0312 


Explanation and Description 


LINK ADDRESS NOT VALID 


Link Address specified in Port Segment Not Valid 


This extended status code is the result of a port segment that specifies a link address 
that is not valid for the target network type. This extended status code shall not be 
used for link addresses that are valid for the target network type but do not respond. 


0x01 


0x0313 
through 
0x0314 


Reserved by CIP 


0x01 


0x0315 


INVALID SEGMENT IN CONNECTION PATH 


Invalid Segment Type or Segment Value in Connection Path 


This extended status code is the result of a device being unable to decode the 
connection path. This could be caused by an unrecognised path type, a segment 
type occurring unexpectedly, or a myriad of other problems in the connection path. 


0x01 


0x0316 


ERROR IN FORWARD CLOSE SERVICE CONNECTION PATH 


The path in the Forward_Close service does not match the connection being closed. 
This means the connection points to a different module or application than is 
specified in the path. The connection is deleted but the error message shall be 
returned. 


0x01 


0x01 


0x0317 


0x0318 


SCHEDULING NOT SPECIFIED 


Either the Schedule Network Segment was not present or the Encoded Value in the 
Schedule Network Segment is invalid (0). 


LINK ADDRESS TO SELF INVALID 


Under some conditions (depends on the device), a link address in the Port Segment 
which points to the same device (loopback to yourself) is invalid. 


0x01 


0x0319 


SECONDARY RESOURCES UNAVAILABLE 


In a dual chassis redundant system, a connection request that is made to the primary 
system shall be duplicated on the secondary system. If the secondary system is 
unable to duplicate the connection request, then this extended status code shall be 
returned. 


0x01 


0x031A 


RACK CONNECTION ALREADY ESTABLISHED 


A request for a module connection has been refused because part of the 
corresponding data is already included in a rack connection. 


0x01 


0x01 


0x031B 


0x031C 


MODULE CONNECTION ALREADY ESTABLISHED 


A request for a rack connection has been refused because part of the corresponding 
data is already included in a module connection. 


MISCELLANEOUS 


This extended status is returned when no other extended status code applies for a 
connection related error. 
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General Extended Explanation and Description 
Status Status 
0x01 0x031D REDUNDANT CONNECTION MISMATCH 
This extended status code shall be returned when the following fields do not match 
when attempting to establish a redundant owner connection to the same target path: 
- O->T_RPI; 
- O->T_connection_parameters; 
- T->O_RPI; 
- T->O_connection_parameters; 
- xport_type_and_trigger. 
0x01 0x031E NO MORE USER CONFIGURABLE LINK CONSUMER RESOURCES 
AVAILABLE IN THE PRODUCING MODULE 
A target shall return this extended status when the configured number of consumers 
for a producing application are already in use. 
0x01 0x031F NO MORE USER CONFIGURABLE LINK CONSUMER RESOURCES 
AVAILABLE IN THE PRODUCING MODULE 
A target shall return this extended status when there are no consumers configured 
for a producing application to use. 
0x01 0x0320 — Vendor specific 
0x07FF 
0x01 0x800 Network link in path to module is offline 
0x01 0x801 — Reserved by CIP 
Ox80F 
0x01 0x810 NO TARGET APPLICATION DATA AVAILABLE 
This extended status code is returned when the target application does not have 
valid data to produce for the requested connection. Only the target side of a 
connection shall return this extended status code. 
0x01 0x811 NO ORIGINATOR APPLICATION DATA AVAILABLE 
This extended status code is returned when the originator application does not have 
valid data to produce for the requested connection. Only the originator side of a 
connection shall indicate this extended status code. 
0x01 0x812 NODE ADDRESS HAS CHANGED SINCE THE NETWORK WAS 
SCHEDULED 
A router on a scheduled network (e.g.: ControlNet) has a different node address 
than the value configured in the connection originator. 
0x01 0x813 NOT CONFIGURED FOR OFF-SUBNET MULTICAST 
A multicast connection has been requested between a producer and a consumer that 
are on different subnets, and the producer is not configured for off-subnet multicast. 
0x01 0x0814 Reserved by CIP 
through 
OxFCFF 
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General Extended 
Status Status 


0x09 


Index to 
Element 


Explanation and Description 


ERROR IN DATA SEGMENT. 


This general status code shall be returned when there is an error in the data segment 
of a forward open. 


The Extended Status shall be the index to where the error was encountered in the 
Data Segment (Reference section C-1.4.5 - DATA SEGMENT). 


0x0C 


Optional 


OBJECT STATE ERROR 


This general status code shall be returned when the state of the target object of the 
connection prevents the service request from being handled. The Extended Status 
reports the object's present state. The extended status is optional. 


For example, a target (application) object of the connection may need to be in an 
edit mode before attributes can be set. This is different from a service being 
rejected due to the state of the device. 


0x10 


Optional 


DEVICE STATE ERROR 


This general status code shall be returned when the state of the device prevents the 
service request from being handled. The Extended Status reports the device's 
present state. The extended status is optional. 


For example, a controller may have a key switch which when set to the "hard run" 
state causes Service Requests to several different objects to fail (ie. program edits). 
This general status code would then be returned. 


3-6 Application Connection Type using Class 0 or 1 Transports 


The Forward Open service of the Connection Manager provides the ability to create two 
network connections at the same time, one Class 0/1 connection in the O=>T direction and the 
other Class 0/1 connection in the T=>O direction. When two connections are created in the 
same Forward Open service request certain behaviors are associated between the two 
connections depending on their application connection type. 


The application type shall determine the target behavior concerning the relationship between 
different connections each sharing a producer, and shall be one of LISTEN_ONLY, 
INPUT_ONLY, EXCLUSIVE_OWNER, or REDUNDANT_OWNER. 


A further element in applying these connections is the real time formats, including Run/Idle 


notification. 
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3-6.1 


3-6.1.1 


3-6.1.2 


Real time formats including RUN/IDLE notification 


Each class 0/1 network connection shall send packets using one of the following real time 
formats: 


Modeless format — no run/idle notification. 

Zero length data format indicates idle. 

Heartbeat format — no run/idle notification. 

32-bit header format includes run/idle notification. 


The real time format supported by a target device is indicated in the Connection Manager 
section, ConnectionN entry, Connection Parameters field of its EDS file. This allows a 
connection originator configuration tool to know the O=>T and T=>O real time formats for 
each connection. 


The connection originator needs to know the real time formats to produce data using the correct 
format and to correctly decode the data it is consuming. The O=>T and T=>O real time 
formats are specified in instance attribute 2 of the Connection Configuration Object. 


The target device needs to know the real time format to decode the data it is consuming and to 
produce data using the correct format. The target device knows the real time formats based on 
the Connection_Path specified in the Forward_Open, each unique Connection_Path is mapped 
to a O=>T real time format and a T=>O real time format. 


Modeless Format 


The modeless real time format may include 0-n bytes of application data and there is no 
run/idle notification included with this real time format. The modeless real time format network 
connection may be either fixed or variable size. 


A class 0 modeless real time packet format is: 


0-n bytes of application data 


A class 1 modeless real time packet format is: 


2 byte sequence count 0-n bytes of application data 


Zero Length Data Format 


When the zero length data real time format includes 1-n bytes of application data the producer 
is indicating run mode. When the zero length data real time format includes 0 bytes of 
application data the producer is indicating idle mode. The zero length data format network 
connection shall be variable size. 


A class 0 zero length data real time packet format showing idle mode is: 


0 bytes of application data 


A class 0 zero length data real time packet format showing run mode is: 


1-n bytes of application data 


A class 1 zero length data real time packet format showing idle mode is: 


2 byte sequence count 
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3-6.1.3 


3-6.1.4 


3-6.2 


A class 1 zero length data real time packet format showing run mode is: 


2 byte sequence count 1-n bytes of application data 


Heartbeat Format 


The heartbeat real time format includes 0 bytes of application data and there is no run/idle 
notification included with this real time format. The modeless real time format network 
connection shall be fixed size. 


A class 0 heartbeat real time packet format is: 


0 bytes of application data 


A class 1 heartbeat real time packet format is: 


2 byte sequence count 0 bytes of application data 
32-Bit Header Format 


The 32 bit header real time format includes 0-n bytes of application data prefixed with 32 bits 
of header. The modeless real time format network connection may be either fixed or variable 
size. 


The 32-bit real time header format prefixed to the real-time data shall be the following form: 


Table 3-6.1 32-Bit Real Time Header 


The run/idle flag (bit 0) shall be set (1 = RUN) to indicate that the following data shall be sent 

to the target application. It shall be clear (0 = IDLE) to indicate that the idle event shall be sent 
to the target application. The ROO and COO fields (bits 1-3) are defined in 3-6.5.4, Redundant 
Owner. The reserved field (bits 4-31) shall be reserved and set to 0. 


A class 0 32 bit header real time packet format is: 


32-bit real time header 0-n bytes of application data 


A class 1 zero length data real time packet format is: 


2 byte sequence count 32-bit real time header 0-n bytes of application data 


Configuration 


Any application type connection may send configuration with a Forward_Open. If present the 
configuration shall be specified in a data segment and shall be delivered to the component 
specified in the configuration path. If no data segment is specified the existing configuration 
continues to be used. If a data segment is specified and no other active I/O connection which 
specified this component exists, the configuration in the data segment shall be applied. If a 
data segment is specified and another I/O connection to this component exists the configuration 
in the data segment shall be compared to the existing configuration; if there are no differences 
the connection may be opened, if there are differences an Ownership Conflict error 
(0x01,0x106) shall be returned. 
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3-6.3 


3-6.4 


3-6.4.1 


3-6.4.2 


3-6.4.3 


Specifying Different Application Connection Types 


The EDS section (chapter 7) of this specification defines how to declare the application 
connection type for a connection. Software tools can use this information to audit and enforce 
connection type issues if desired (issues like multiple exclusive owner connections to the same 
target, only listen only connections to a target, exclusive owner connection with redundant 
owner connection to the same target, etc.). 


There is no requirement for connection originator devices or bridge/router devices to take 
action based on connection type (other than redundant owner connections), so the connection 
type is not explicitly included in the forward open data (with the exception of redundant owner 
connections). A specific connection path shall have a single application connection type. The 
target device can then take the appropriate actions for the connection based on the application 
connection type definitions below. 


Application types 


The requirements for each of the 4 connection types, Listen Only, Input Only, Exclusive Owner 
and Redundant Owner are detailed in this section. 


Listen only 


If a connection has an application type of listen only, it shall be dependent on a non-Listen only 
application connection for its existence. For a scheduled listen only connection, the 
Forward_Open path shall contain a schedule segment. The O=>T connection shall use the 
heartbeat format as described in section 3-6.1.3. A target may accept multiple listen only 
connections which specify the same T=>O path. Devices that wish to listen to multicast data 
without providing configuration may use this application type. If the last connection on which a 
listen only connection depends is closed or times out, the target device shall stop sending the 
T=>O data which will result in the listen only connection being timed out by the originator 
device. 


Input only 


If a connection has an application type of input only, it shall not be dependent on any other 
connection for its existence. For a scheduled input only connection, the Forward_Open path 
shall contain a schedule segment. The O=>T connection shall use the heartbeat format as 
described in section 3-6.1.3. A target may accept multiple input only connections which 
specify the same T=>O path. A specific implementation may limit the number of input only 
connections it accepts. In addition, the target may accept listen only connections that use the 
same multicast T=>O data. 


Exclusive Owner 


If a connection has an application type of exclusive owner, it shall not be dependent on any 
other connection for its existence. For scheduled exclusive owner connections, the 
Forward_Open path shall contain a schedule segment. O=>T application data that controls 
outputs may be present. A target may only accept one exclusive owner connection which 
specifies the same O=>T path. In addition, the target may accept listen only and input only 
connections that use the same multicast T=>O data. 
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3-6.4.4 
3-6.4.4.1 


The term connection owner shall refer to the connection originator whose O=>T packets are 
being consumed by the target object. The term owning connection shall refer to the connection 
associated with connection owner. 


When an exclusive owner connection timeout occurs in a target device, the target device shall 
stop sending the associated T=>O data. The T=>O data must not be sent even if one or more 
input only connections exist. This requirement exists to signal the originator of the exclusive 
owner connection that the O=>T data is no longer being received by the target device. 


NOTE: One possible way to prevent an exclusive owner connection timeout in a target device 
from stopping the T=>O production is for the target device to also support production of the 
T=>O data as point to point for the exclusive owner connection. 


Redundant owner 
General 


The redundant owner connection shall allow multiple separate originator applications to each 
establish an independent, identical connection to the transport of a target application. The target 
transport shall in turn send events to the target application so that the redundant owner 
connection appears as a single, exclusive owner connection to the target application. At most 
one of the originator applications shall have its data applied to the target application. The target 
transport shall multicast the target application data to each of the originator applications. 


When a single redundant owner connection exists and a redundant owner connection timeout 
occurs in a target device, the target device shall stop sending the associated T=>O data. The 
T=>O data must not be sent even if one or more input only connections exist. This requirement 
exists to signal the originator of the redundant owner connection that the O=>T data is no 
longer being received by the target device. 


NOTE: One possible way to prevent a redundant owner connection timeout in a target device 
from stopping the T=>O production is for the target device to also support production of the 
T=>O data as point to point for the redundant owner connection. 


NOTE: The redundant owner connection may commonly be used in applications where up time 
is at a premium. In these applications, multiple originator applications can each establish a 
connection to a target application (typically an output application). Should an originator 
application fail or otherwise give up control, another originator application can quickly have its 
data applied to the target application without having to establish a connection with the target. 
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3-6.4.4.2 


3-6.4.4.3 
3-6.4.4.3.1 


3-6.4.4.3.2 


3-6.4.4.3.3 


Establishing the Connection 


A redundant owner connection and an exclusive owner connection shall not both be established 
to a target application at the same time. Multiple redundant owner connections may be 
established to the same target simultaneously provided that the following fields of the 
Forward_Open request are identical and the connection paths match. The connection path shall 
match including any data segments. 


e O2T_RPI; 
e O2T_connection_parameters; 
e T20_RPI; 


e T2O_connection_parameters; 
e xport_type_and_trigger. 


The target shall return general status = 0x01 and extended status = 0x031D if any of these 
fields do not match. 


The target transport shall only send the CM_open_indication to the target application when the 
first Forward_Open is received. Subsequent redundant Forward_Opens shall not cause a 
CM_open_indication to be sent to the target application. 


NOTE: Bit 15 of the Forward Open request.O->T_connection_parameters specifies whether 
the connection is an exclusive owner or redundant owner connection 


Redundant owner O->T data format 
General 


The Redundant owner shall use the 32-bit header format described in section 3-.6.1.4. 


Claim Output Ownership (COO) Flag 


The COO flag shall be set (1) when an originator application wants its connection to be the 
owning connection of the target application. The COO flag shall be reset (0) when an originator 
application does not want its connection to be the owning connection of the target application. 
When the owning connection resets (0) its COO flag, its sibling connections shall be checked 
for a set (1) COO flag. The new owner shall be any of the connections that have their COO flag 
set. 


NOTE: This results in undefined behavior if more than one other connection has its COO flag 
set. 


Ready for Ownership of Outputs (ROO) Priority Value 


The ROO priority value shall be non-zero when an originator application does not want to force 
its connection to be the owning connection of the target application, but is ready to be the 
owning connection should there be no originator applications claiming to be the owning 
connection. The ROO priority value shall be zero when the originator application does not want 
to be the owning connection of the target connection and is not to be the owning connection 
should there be no originator application claiming to be the owning connection. The ROO 
priority value shall be used only when the COO flag is reset. 


The value of the ROO field can range from 0 to 3. The originator applications shall each 
determine a unique non-zero ROO value. 
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3-6.4.4.4 


3-6.4.4.5 


Determining the owning connection 


The originator applications shall determine among themselves which originator application has 
the owning connection. The owning connection shall be determined by the originator 
application that sets its COO flag. In situations where multiple originator applications have 
their COO flag set or where no originator connections have their COO flag set, the following 
rules shall be applied by the target transport to determine the owning connection. 


There shall be no owning connection until an originator application sends a real-time 
packet with the COO flag set; 

If there is only one originator application which had the COO flag set in its last realtime 
packet, that originator application shall have the owning connection; 

If there are multiple originator applications which had the COO flag set in its last realtime 
packet, the last originator application that transitioned its COO flag from reset to set shall 
have the owning connection. 

If the originator application with the owning connection resets its COO flag, closes its 
connection, or if that connection times out, and no other originator applications have their 
COO flags set, the originator application with the highest non-zero ROO priority value 
shall have the owning connection. 

If all of the originator applications have their COO flags reset and ROO priority values set 
to zero, there shall be no owning connection. 

When the first real-time packet containing a set COO flag is received by the target 
transport, the originator application that sent the real-time packet shall have the owning 
connection. 


Transporting events and data to a target application 


The connection related events from each of the redundant owner connections shall be combined 
using the following rules such that the target application sees only a single exclusive owner 
connection: 


Until an owning connection is initially determined, the transport shall not indicate realtime 
data reception to the target application; 

If an owning connection is determined, the transport shall indicate the event consistent with 
the owning connections real-time data to the target application. If the Run/Idle flag is reset 
in the real-time data for the owning connection, the transport shall indicate the idle state to 
the target application. If the Run/Idle flag is set in the real-time data for the owning 
connection, the transport shall indicate the run state and the real-time data to the target 
application; 

If an owning connection had been previously determined, but no originator is currently 
claiming or ready for ownership, the transport shall indicate idle state to the target 
application; 

If all the redundant connections are closed or have been timed out, the target transport shall 
indicate the event consistent with the last connection to have been closed or timed out to 
the target application. 
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3-7 Port Object Class Definition 
Class Code: F4 hex 


The Port Object enumerates the CIP ports present on the device. One instance exists for each 
CIP port. 


3-7.1 Port Object Class Attributes 


The Port Object Class attributes are defined below in Table 3-7.1. 


Table 3-7.1 Port Class Attributes 


ie Need In Access Attribute Data Type Attribute Description Semantics of 
Implementation} Rule Name Values 


This class attribute is — and is described in Chapter 4 of this specification. 


Required Max Instance | UINT Maximum instance 
number. 
Required UINT Number of ports 
Tntes currently instantiated. 


4-7 | These class attributes are optional and are described in Chapter 4 of this specification. 


Required Entry Port UINT Returns the instance of 
the Port Object that 
describes the port 
through which this 
request entered the 
device. 


Required Port Instance | ARRAY of Array of structures The array is 

Info STRUCT of containing instance indexed by 
attributes 1 and 2 from instance number, 
each instance. up to the maximum 
number of 
instances. The 
values at index 1 
(offset 0) and any 
non-instantiated 
instances shall be 
zero. 


Port Type UINT Enumerates the type of See instance 
port attribute #1 

Port Number |UINT CIP port number See instance 
associated with this port | attribute #2 
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3-7.2 Port Object Class Services 
The Port Class supports the following CIP Common Services: 
Table 3-7.2 Port Class Services 
Service Need In Service Name Service Description 
Code | Implementation 
O1lhex Get_Attributes_ All Returns the contents of all attributes of the class. 
OEhex | Conditional Get_Attribute_ Used to read a Port Class attribute value. This service is 
Single Required if any of the Port Class Attributes are supported. 
3-7.3 Port Object Instance Attributes 
The following list provides a summary of the Port Instance attributes and their associated data 
types. 
Table 3-7.3 Port Object Instance Attributes 
Attr | NeedIn | Access| NV | Attribute Name Data Type Description of Semantics 
ID Implem | Rule Attribute 
1 Required Get NV | Port Type UINT Enumerates the type | 0 = connection terminates in 
of port this device 
1 = reserved for 
compatibility with existing 
protocols 
2 = ControlNet 
3 = ControlNet redundant 
4 = EtherNet/IP? 
5 = DeviceNet 
6 — 99 = reserved for 
compatibility with existing 
protocols 
100 — 199 = Vendor Specific 
200 = CompoNet 
201 = Modbus/TCP 
202 = Modbus/SL 
203 — 65534 = Reserved for 
future use 
65535 = unconfigured port 
2 Required Get NV | Port Number UINT CIP port number Manufacturer assigns a 
associated with this | unique value to identify each 
port communication port. Value 
1 is reserved for internal 
product use (ie. backplane). 
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Attr 


Need In 
Implem 


Required 


Required 


Access 
Rule 


Get 


Get 


NV 


NV 


Attribute Name 


Link Object 


Data Type 


STRUCT of 


Description of 
Attribute 


Semantics 


Path Length 


UINT 


Number of 16 bit 
words in the 
following path 


Range =2-6 


Link Path 


Port Name 


Padded 
EPATH 


SHORT_ 
STRING 


Logical path 
segments that identify 
the object for this 
port. For example, 
this could be the 
TCP/IP Interface 
Object. 


String which names 
the physical network 
port. The maximum 
number of characters 
in the string is 64. 
For example, this 
may be “Port A”. 


The path shall consist of one 
logical class segment and 
one logical instance segment. 
The maximum size is 12 
bytes. See Appendix C, 
Logical Segments. 


This value is unique for each 
physical network port. If 
multiple CIP ports use the 
same physical network port, 
they shall each have the 
same Port Name value. 
Likewise, a CIP port shall 
not have the same Port Name 
value as any other CIP port if 
they do not share the same 
physical network port. 


Optional 


Get 


NV 


Port Type Name 


SHORT_ 
STRING 


String which names 
the port type. The 
maximum number of 
characters in the 
string is 64. For 
example, this may be 
“DeviceNet”. 


Optional 


Set 


NV 


Port Description 


SHORT_ 
STRING 


String which 
describes the port. 
The maximum 
number of characters 
in the string is 64. 
For example, this 
may be “Product Line 
22”, 


Required 


Conditional 


Get 


Get 


NV 


NV 


Node Address’ 


Port Node Range” 


Minimum Node 
Number 


Padded 
EPATH 


STRUCT of 
UINT 


Node number of this 
device on port. The 
range within this data 
type is restricted toa 
Port Segment. 


Minimum node 
number on port. 


The encoded port number 
shall match the value 
presented in attribute 2. 


Maximum Node 
Number 


UINT 


Maximum node 
number on port. 


Optional 


Get 


NV 


Port Key 


Packed 
EPATH 


Electronic key of 
network/chassis this 
port is attached to. 
This attribute shall be 
limited to format 4 of 
the Logical 
Electronic Key 
segment. 
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Semantics 


1 A device which does not have a node number on the port can indicate a zero length node address within the 
Port Segment (0x10 0x00). 

2 Ifa device can report its port characteristics within the range allowed (e.g. DeviceNet MACID) then it shall 
support this attribute. Otherwise (e.g. EtherNet/IP IP Address) it shall not support this attribute. 

3 This port type was formerly known as TCP/IP 


3-7.4 Port Object Instance Common Services 


The Port Object Instance supports the following CIP Common services: 


Table 3-7.4 Port Object Instance Common Services 


Service Need In Service Name Service Description 
Code Implementation 
O1lhex Get_Attributes_All Returns the contents of all attributes of the class. 


OEhex Conditional Get_Attribute_Single | Used to read a Port Object instance attribute. This service is 
Required if any of the Port Instance Attributes are 
supported. 


10hex Set_Attribute_Single 
3-7.4.1 Get_Attributes_All Response 


The Get_Attributes_All response for the class attributes shall concatenate attributes 1, 2, 3, 8 
and 9 in that order. If class attribute 1 (Revision) is not supported, then a default value of one 
(1) shall be returned. The Get_Attribute_All response for the instance attributes shall 
concatenate attributes 1, 2, 3,4 and 7 in that order. 
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4-1 Introduction 


This chapter includes an explanation of how to read the object specifications in the library. 
Each object is defined using the same format. 


For information about Go to Section 
Reading an Object Specification 4-1 
Description of Object 4-2 
Class Code 4-3 
Attributes 4-4 
Common Services 4-5 


Object-specific Services 4-6 
Behavior 4-7 


Connections 4-8 


Each specification contained in the library is defined based on the contents of an object. 


An object consists of the following. See Figure 4-1.1. 


e aset of closely related attributes (data) 

e aset of behaviors 

e aset of services (common or object—specific) 
e aset of connections 


Figure 4-1.1 Defining an Object Specification 


Behaviors 


Connections 
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The objects in the CIP Application Object Library are defined in the following terms: 


Table 4-1.1 Object Definitions 


Description a description of the object being specified 

Class Code a hexadecimal identifier assigned to each CIP object 
Attributes the data associated with this object 

Common Services a list of the common services defined for this object 


Object-specific Services | the full specifications of any services unique to this object 


Connections connections supported by this object 
Behavior the relationship between attribute values and services 
4-2 Description 


Every object specification begins with a brief functional definition of the object being defined. 
For example, the Description of the Identity Object reads: This object provides identification of 
and general information about the device. 


4-3 Class Code 


This part of the definition is a hexadecimal value unique to an object. Use the class code to 
identify the object class when accessing objects in devices. Open DeviceNet Vendor 
Association and ControlNet International are responsible for allocation and coordination of the 
class codes. However, managing Vendor Specific class codes and guaranteeing the values are 
unique to a Vendor ID is the responsibility of individual member companies. 


In addition to the individual object definition, a summary list of all the objects and 
their class codes is located at the beginning of the Object Library. 


4-4 Attributes 


The Attribute part of an object specification is divided into two sections: 


e Class attributes 
e Instance attributes 
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4-4.1 Class Attributes 


A Class Attribute is an attribute that is shared by all objects within the same class. Class 
Attributes are defined using the following terms: 


Table 4-4.1 Class Attribute Fields 


Attribute Need in Access NV Name CIP Data Description of Semantics of 
ID Implementation Rule Type Attribute Values 


1. Attribute ID is an integer identification value assigned to an attribute. Use the Attribute 
ID in the Get_Attributes and Set_Attributes services list. The Attribute ID identifies the 
particular attribute being accessed. 


2. Need in Implementation specifies whether or not the attribute is necessary in the object 
class implementation. An attribute may be Optional, Required or Conditional. 


A conditional attribute is required if certain object behaviors and/or attributes are 
implemented as defined by the class or within the Device Profile. 


Important: If a Class Attribute is optional, then you must define a default value. 


If the default value of an optional attribute does not match the behavior of the object when 
the object does not implement the attribute, the object definition shall declare the behavior. 


In all cases, the term “default” indicates a “factory default” as shipped from the vendor. 


3. The Access Rule specifies how a requestor can access an attribute. The definitions for 
access rules are: 


e Settable (Set) — The attribute can be accessed by one of the Set_Attribute services. If the 
behavior of your device does not require a Set_Attribute service, then you are not 
required to implement the attribute as settable. 


Important: Settable attributes can also be accessed by Get_Attribute services. 
e Gettable (Get) — The attribute can be accessed by one of the Get_Attribute services. 


4. NV indicates whether an attribute value is maintained through power cycles. This column 
is used in object definitions where non-volatile storage of attribute values is required. An 
entry of ‘NV’ indicates value shall be saved, ‘V’ means not saved. 


5. Name refers to the attribute. 

6. Data Type is used in the Get_ Attribute and Set_Attribute services. You must follow the 
specified data type for all products using the attribute being defined. CIP data types and 
their ranges are defined in Appendix C. 

7. Description of Attribute provides general information about the attribute. 

8. Semantics of Values specifies the meaning of the value of the attribute. 

AG a 
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Important: Seven Class Attribute IDs are reserved for class object definitions. They are: 


e Revision 

e Max Instance 

e Number of Instances 

e Optional Attribute list 

e Optional Service list 

e Maximum Number Class Attributes 

e Maximum Number Instance Attributes 


Because these attributes are reserved, attribute ID numbers 1 through 7 are always reserved. 
Therefore, if you want to add a class attribute to an object definition, you must start with 
attribute ID #8. Unless otherwise specified in an object definition, each class attribute 
numbered 1 through 7 exists as an optional attribute within each class. 


The seven reserved Class Attributes have the following definitions: 


Table 4-4.2 Reserved Class Attributes for All Object Class Definitions 


Attribute Need in Access Name Data Type Description of Semantics of 
ID Implementation | Rule Attribute Values 


1 Conditional * Get Revision UINT Revision of this The current value 

object assigned to this 
attribute is one 
(01). If updates 
that require an 
increase in this 
value are made, 
then the value of 
this attribute 
increases by 1. 

2 Optional Max Instance | UINT Maximum instance | The largest 
number of an object | instance number 
currently created in | of a created 
this class level of object at this 
the device. class hierarchy 

level. 

3 Optional Number of UINT Number of object The number of 

Instances instances currently | object instances 
created at this class | at this class 
level of the device. | hierarchy level. 


Optional Get Optional STRUCT of List of optional A list of attribute 
attribute list instance attributes | numbers 
utilized in an object | specifying the 
class optional attributes 
implementation. implemented in 
the device for this 
class. 


ODVA & ControlNet International, Ltd. 


number of UINT Number of The number of 
attributes attributes in the attribute numbers 
optional attribute in the list. 
list. 
optional ARRAY of List of optional The optional 
attributes UINT attribute numbers. attribute numbers. 
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Attribute Need in Access Name Data Type Description of 
ID Implementation | Rule Attribute 
5 List of optional 


Optional Get Optional STRUCT of 
service list 
number 
services 
optional ARRAY of 
services UINT 


services utilized in 
an object class 
implementation. 


Number of services 
in the optional 
service list. 


List of optional 
service codes. 


The attribute ID 
number of the last 
class attribute of the 
class definition 
implemented in the 
device. 


The attribute ID 
number of the last 
instance attribute of 
the class definition 
implemented in the 
device. 


Maximum ID | UINT 
Number Class 
Attributes 


| 
| 


Maximum ID | UINT 
Number 

Instance 

Attributes 


Semantics of 
Values 


A list of service 
codes specifying 
the optional 
services 
implemented in 
the device for this 
class. 


The number of 
service codes in 
the list. 


The optional 
service codes. 


* If the value is 01, then this attribute is OPTIONAL in implementation. If the value is greater than 01, then this 


attribute is REQUIRED. 
4-4,2 Instance Attributes 
An Instance Attribute is an attribute that is unique to an object instance and not shared by the 
object class. 
Instance Attributes in the Object Library are defined in the same terms as Class Attributes. 
There are no reserved Instance Attributes. 
Table 4-4.3 Instance Attribute Fields 
Attribute Need in Access NV Name | CIP Data | Description of | Semantics 
ID Implementation | Rule Type Attribute of Values 
1 2 3 4 5 6 7 8 
4-5 Common Services 


Common Services are those whose request/response parameters and required behaviors are 


defined in CIP Common, Appendix A. 


The Common Service component of an object definition includes: 
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Table 4-5.1 Common Service Fields 


‘ Need in 4 ae 
Service 4 Service Description of 
Implementation 


2-3. 


Code Instance Name Service 


Service Code is the hexadecimal value assigned to each CIP service. 


Need in implementation specifies whether or not the service is needed in the 
implementation of this object at the Class level or at the Instance level. In these columns 
will appear one of four specifications: 


e Optional; or 

e Required; or 

e Conditional; or 

e Not applicable (“n/a”) 


A conditional service is required if certain object behaviors, attributes and/or services are 
implemented as defined by the object. All conditional services shall specify the 
condition(s) that qualify the service to be required. If the need in implementation is 
specified as Not Applicable at the class or instance level, it shall not be supported at that 
level. 


Important: If an optional service is implemented in a class, and the optional Service List 
class attribute is also implemented in the class, the service shall be included in the Service 
List. 


Services trigger the Behavior of an object based on the values of the attributes accessed 
by the service. Common Services can be directed to either the Class 

level or the Instance level of an object, which may produce different behavior 

at each level. 


e Class Level: behavior triggered by services sent to the Object Class. 
e Instance Level: behavior triggered by services sent to the Object Instance. 


Table 4-5.2 Common Service Naming Conventions 


Common Services sent to Are called 


the Class Level of an object Common Class Level Services 


the Instance Level of an object Common Instance Level Services 


Service Name refers to the service. See CIP Common, Appendix A for a complete list of 
CIP common services. 


Description of Service provides a brief definition of the service. 
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4-5.1 


4-5.2 


Get_Attributes_All Response 


When the Get_Attributes_All common service is included in the list of supported common 
services, then the Get_Attributes_All response shall be included in the object definition. This 
specifies the structure of the data returned in the Service Data portion of Explicit Response 
Message. (This is the Response_Data field described in the Message Router Response Format. 
See Chapter 2 for the definition.) The following byte array is an example of how the structure 
of the Service Data portion of a Get_Attributes_All response is typically specified: 


Table 4-5.3 Example Get_Attributes_All Response Data — Class Level 


Revision (low byte) Default = 1 


a 
® 


Revision (high byte) Default = 0 
Max Instance (low byte) Default = 0 
Max Instance (high byte) Default = 0 
Number of Instances (low byte) Default = 0 
Number of Instances (high byte) Default = 0 
Optional Attribute List : number of attributes (low byte) Default = 0 
Optional Attribute List : number of attributes (high byte) Default = 0 
Optional Attribute List : optional attribute #1 (low byte) 


Omni ny oy R]_ Ww] Nnirylo 


Optional Attribute List : optional attribute #1 (high byte) 


n Optional Attribute List : optional attribute #m (low byte) 
n+1 Optional Attribute List : optional attribute #m (high byte) 


Important: Insert default values for all unsupported attributes. 


The following rules are to be adhered to when specifying an object’s Get_Attributes_All 
response format: 


e Default values shall be supplied for all ”optional” attributes. If a product chooses not to 
implement some of the optional attributes it will be required to insert the specified default 
value for the unimplemented attribute. 

e If new attributes are added to the response structure, those attributes shall be added to the 
end. 


For CIP defined (public) objects, the definition of the Get_Attributes_All response data is 
controlled by CIP. Inclusion of vendor specific or any other data in the response data is not 
allowed. 


Set_Attributes_All Request 


When the Set_Attributes_All common service is included in the list of supported common 
services, then the Set_Attributes_All request must be included in the object definition. This 
specifies the sequence or order of the data supplied in the Service Data portion of the request. 
(This is the Request_Data field described in the Message Router Request Format. See Chapter 
2 for the definition.) The following byte array is an example of how the format of the Service 
Data portion of a Set_Attributes_All request is typically specified: 
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At the Instance level, the order of attributes passed in the Set_Attributes_AI] request is as 
follows: 


Table 4-5.4 Set_Attributes_All Request Data 
Output Range 
Value Data Type 

Fault State 

Idle State 
Fault Value (low byte) 
Fault Value (high byte) 
Idle Value (low byte) 
Idle Value (high byte) 


NYT OD] Oa) BR] wl) NMTrRI|o 


For CIP defined objects, the definition of the Set_Attributes_All service data is controlled by 
CIP. Inclusion of vendor specific or any other data in the service data is not allowed. 


4-5.3 Optional Services 


All objects shall have the following services defined as Optional at both the Class and Instance 
level unless otherwise specified by an object class as Conditional or Required. Services not 
listed here or in the object definition shall not be supported. 


e Get_Attribute_Single 

e Set_Attribute_Single 

e Get_Attribute_List 

e Set_Attribute_List 

e Multiple_Service_Packet 
e No_Operation (NOP) 

e Get _Member 

e Set _Member 

e Insert_Member 

e Remove_Member 


4-6 Object-specific Services 


The section titled “Object-specific Services” provides a list of the unique services supported by 
this class of objects and their service codes. 


Whereas Common Services can be used in many objects, Object—specific Services are unique 
to each object. 


For example, many objects support the Get_Attributes_All service; however, only the 
DeviceNet Object supports Allocate_Master/Slave_Connection_Set (see DeviceNet 
Specification, Volume 3). 
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The Object—specific Services component of the object class definition includes: 


Table 4-6.1 Object-specific Service Data Fields 


Service Dpedin 
Implementation 
Code Class Instance Service Name Description of Service 
1 2 3 4 5 
1. Service Code is the hexadecimal value assigned to each CIP service. 


2-3. Need in implementation specifies whether or not the service is needed in the 
implementation of this object at the Class level or at the Instance level. In these columns 
will appear one of four specifications: 


e Optional; or 

e Required; or 

e Conditional; or 

e Not applicable (“n/a”) 


A conditional service is required if certain object behaviors, attributes and/or services are 
implemented as defined by the object. All conditional services shall specify the 
condition(s) that qualify the service to be required. If the need in implementation is 
specified as Not applicable at the class or instance level, it shall not be supported at that 
level. 


Important: If a service is specified to be optional and is implemented in a device, its 
service code must be included in the “optional service list” class attribute. 


Services trigger the Behavior of an object based on the values of the attributes accessed 
by the service. Object-specific Services can be directed to either the Class 

level or the Instance level of an object, which may produce different behavior 

at each level. 


e Class Level: behavior triggered by services sent to the Object Class. 
e Instance Level: behavior triggered by services sent to the Object Instance. 


Table 4-6.2 Object-specific Service Naming Convention 


Are called 
Object—-specific Class Level Services 


Object-—specific Services sent to 
the Class Level of an object 


the Instance Level of an object Object—specific Instance Level Services 
4. Service Name refers to the service. 
5. Description of Service provides a brief definition of the service. 
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4-6.1 Service Parameters 


Whereas each Common Service has fixed parameters, each Object—specific Service has unique 
parameters. This section defines those parameters for each Object—specific Service. 


Table 4-6.3 Object-specific Service Parameter Field Descriptions 


Name Type Description of Request Parameters Semantics of Values 
1 2 3 4 
1. Name refers to the service request parameter. 
2. Type specifies the data type of the service request parameter. 
3. Description of Request Parameters describes the purpose of the request parameter. 
4. Semantics of Values specifies the meaning of the values of the service request 


parameter, such as “the value is counts of microseconds.” 


4-6.2 Service Response Data 


Table 4-6.4 is the description of the service response data that includes the following: 


Table 4-6.4 Object-specific Service Response Data 


Name Type Description of Response Data Semantics of Values 


1 Z 3 4 


1) Name refers to the service response data. 

2) Type specifies the data type of the service response data. 

3) Description of Response Data describes the purpose of the response data. 

4) Semantics of Values specifies the meaning of the values of the service response data. 


This object definition component also includes a description of the usage and purpose of the 
service. If the service triggers a complex behavior, then you must specify it. Response Data 
from CIP Common services shall conform to that specified in CIP Common, Appendix A 
unless specified otherwise in the Object Definition or Device Profile. 


4-7 Behavior 


Behavior of an object may be triggered by an object’s services and is based on the values of the 
attributes accessed by the service. Together, the services and attribute values initiate state 
changes in the object. The behavior definition determines how an object responds when it 
receives notification of an event that changes its state. Behavior must be defined in terms of: 


e the state an object is in when it receives notification of a state-changing event; and 
e the event the object receives. 
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4-7.1 


State 


A state is an object’s current active mode of operation (e.,g., Running, Idle). 


To define behavior in these terms, use a State Event Matrix and a State Transition Diagram 
when applicable. A State Event Matrix is a table that lists all possible events and services that 
initiate a state change, and indicates an object’s response to the event or service based on the 
state of the object when it receives notification of that event. 


For example, the table below shows three states (other objects may or may not have other 


states): 


e Non-existent: the object has not yet been created. You must implement the create service to 
transition the object to existent. 
e Idle: the object accepts services (e.g., Start, Stop, Get_Attribute_Single), but does not 


produce. 


e Running: the object is performing its function. 


Table 4-7.1 State Event Matrix Table Format 


Event 


Create 


Delete 


Start 


Stop 


Get_Attribute_Single 


Set_Attribute_Single 


Transition to Idle 


Error: Object does not 
exist. (General Error 
Code 0x16) 


Error: Object does not 


exist. (General Error 
Code 0x16) 


Error: Object does not 
exist. (General Error 
Code 0x16) 


Error: Object does not 
exist. (General Error 
Code 0x16) 


Error: Object does not 
exist. (General Error 
Code 0x16) 


State 
Idle 


Error: Object already exists. 


Transition to Non-Existent 


Transition to Running 


Error: Object State Conflict 
(General Error Code 0x0C) 


Validate/service the request. 


Return response 


Validate/service the request. 


Return response 


Running 


Error: Object already 


exists. 


Error: Object State 
Conflict (General Error 
Code 0x0C) 


Error: Object State 
Conflict (General Error 
Code 0x0C) 


Transition to Idle 


Validate/service the 
request. Return response 


Error: Object State 
Conflict (General Error 
Code 0x0C) 
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4-7.2 Event 


An event is an external stimulus that could cause a state transition. A State Transition 
Diagram graphically illustrates the state of an object and includes services and attributes that 
cause it to transition to another state. 


Figure 4-7.1 State Transition Diagram Example 


Non-Existent 


Create Delete 


Get_Attribute_Sin gle/ 
Set_Attribute_Single 


Stop 


Running 
Produce/Consume data, 
Get_Attribute_Single 


When applicable, some object behavior definitions include an Attribute Access Table, which 
lists all object attributes and how to access them in a given state. 


Table 4-7.2 Attribute Access Table Example 


Attribute State 


Number_of_Members Read Only 
Member_List Not available Read Only 
Data Not available Read Only 
Owner Not available Read Only 


4-8 Accessing Application object data 


An Object Class definition must indicate any special provisions that have been made with 
regards to the external access of its associated data. 


As described in Chapter 1 of Volume 1, two types of Connections exist; Implicit (I/O) and 
Explicit Messaging. This section provides an overview of how these Connection types relate to 
Application Objects and how they can be used to access Application Object data. Figure 4-8.1 
presents an overview of the relationship between the Connection Class and Application Objects 
and serves as a prefix to the overview. 
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Figure 4-8.1 Connection Paths 
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4-8.1 Access Through Explicit Messaging Connections 


An Explicit Messaging Connection is capable of accessing any externally accessible object, 
including Application Objects. Explicit Messages can be used to deliver various service 
requests to Application Objects, including the reading and writing of Application Object 
attributes. 


When an Explicit Message is received, the Explicit Messaging Connection delivers the 
message information to the Message Router. The Message Router delivers the message 
information to the appropriate handler. In the case of an Explicit Request Message, the 
handler is the target object specified in the request. In the case of an Explicit Response 
Message, the handler is the Client Application that previously issued the associated request. 


4-8.2 Access Through I/O Connections 


I/O Connections contain attributes that point to or reference the Application Object(s) to which 
they deliver received data and/or from which they obtain data to transmit. 
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Figure 4-8.2 Access Paths to Application Object Data via I/O Connections 
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Application Objects can be directly referenced by an I/O Connection. This is illustrated by 
EXAMPLE 1 in Figure 4-8.2. In this example, Attribute #3 within Application Object Class 
#8/Instance #2 (Att #3), is being directly accessed by an I/O Connection. If this reference was 
made by the produced_connection_path attribute of the I/O Connection, then Att #3 data 
would be the information being produced by the I/O Connection. If this reference was made by 
the consumed_connection_path attribute of the I/O Connection, then Att #3 would be the 
recipient of the data that is consumed by the I/O Connection. 


It is possible to access multiple attributes over a single I/O Connection. This is accomplished 
using a special Application Object called the Assembly Object. With respect to data exchange 
over an I/O Connection, an Assembly Object performs the following: 


e Assembles separate pieces of Class, Instance, and/or Attribute data together so they can be 
produced by a single I/O Connection. 

e Receives data from an I/O Connection that is associated with separate Classes, Instances, 
and/or Attributes and distributes the data accordingly. 


With this in mind, Assembly Objects provide an indirect reference to various data items. 
EXAMPLE 2 in Figure 4-8.2 illustrates an Assembly Object that groups Attributes #1 and #2 
of Class #8/Instance #2 so they can be accessed by a single I/O Connection. Note that an 
Assembly Object is capable of referencing items within more than 1 Object Class. See CIP 
Common, Chapter 5—5 for a detailed definition of the Assembly Class. 
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4-9 Extending Existing Objects and Defining New Objects 


If your application requires a function that existing objects do not implement, you can: 

e Add vendor-specific attributes to existing objects, or propose a standardized open addition 
to existing objects; 

e Define a new open object or a new vendor-specific object (published or unpublished) to 
accommodate a new or revised functionality 


Use the decision table below to determine how you would like to add functionality to your 
device. 


An Object Class definition must indicate any special provisions that have been made with 
regards to the external access of its associated data. 


Table 4-9.1 How to Add Functionality 


If you And Then 


want to add attributes and/or services to an | you want this extension to | propose an Open Extension. 
existing object to extend its functionality, | be standardized, 


want to add attributes and/or services to an | you want to provide user-— | create and publish a Vendor-specific 


existing object to extend its functionality, | access to the extension, Extension. 
want to add attributes and/or services to an | you want to keep the create, but do NOT publish 
existing object to extend its functionality, | extension proprietary, Vendor-specific Extension. 


want to create a device that has a function | you want this extension to | propose a new Open Object. 
outside the realm of existing objects, be standardized, 


want to create a device that has a function | you want to provide user-— | create and publish a new Vendor-specific 
outside the realm of existing objects, access to the extension, Object. 


want to create a device that has a function | you want to keep the new | create but do NOT publish a new 
outside the realm of existing objects, object proprietary, Vendor-specific Object. 


After determining whether you want to extend an existing object or define a new one, refer to 
the following pages for the appropriate information. 


Table 4-9.2 Where To Go To Make Changes 


For information about: Go to section: 
CIP Object Address Ranges 4-9.1 
Making Extensions to Objects 4-9.2 
Vendor-specific Extensions 4-9.2.1 
Open Extensions 4-9.2.2 
Defining a New Object 4-9.3 
Vendor-specific Object 4-9.3.1 
Open Object 4-9.3.2 
Defining a New Common Service 4-9.4 
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4-9.1 CIP Object Address Ranges 


Whether you decide to extend existing open objects or define new objects, you must know the 
ClIP—defined Object Addressing Ranges. There are three categories: 


Table 4-9.3 Object Address Range Categories 


This range Refers to 


Open A value available to all CIP participants. Open values are defined in the CIP Common 
Specification and the associated network companion specifications. All Object Classes and 
services defined in CIP Specification fall under this category. 


Vendor- A range of values specific to the vendor of a device. These are used by vendors to extend their 

specific devices beyond the available Open options. A vendor internally manages the use of values 
within this range. Applies to object classes, attributes, and services. 

Object-class- A range of values who’s meaning is defined by an Object Class. This range applies to Service 

specific Code definitions. 


Table 4-9.4 defines the ranges applicable to Class ID values. 


Table 4-9.4 Class ID 


Table 4-9.5 defines the ranges applicable to Attribute ID values. 


Table 4-9.5 Attribute ID Range 
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Table 4-9.6 defines the ranges applicable to Service Code values. 


Table 4-9.6 Service Code Ranges 


= Quant 
00 - 31pex Open. These are referred to as CIP Common 50 
Services. These are defined in Appendix A. 
32hex - 4Ahex Vendor Specific 25 
4Bhex - ©3hex Object Class Specific 25 


64hex - 7Fhex Reserved by CIP for future use 28 
80hex - FFhex Invalid/Not used 128 


4-9.2 Making Extensions to Objects 


If an existing open object provides functions that closely match those of your product but do 
not completely support an implementation, then you may want to extend the existing object 
instead of creating a new object. 


You can modify the existing object to include a new behavior that would satisfy your desired 
function. A modification could entail simply adding state flags or diagnostics, or could mean 
inheriting behaviors of another existing object class in your product line. 


There are two types of extensions to open objects: 


e vendor specific 
e published (via user manual, EDS, etc) 
e unpublished 
e open (extensions may be made only via actions in CIP Special Interest Groups) 


An extension of an existing open object definition: 


e can add new open or vendor specific attributes to the most recent definition. Deletion of 
open attributes is not allowed. Open attributes can be obsoleted, but obsoleted attributes 
shall still be shown in the object definition and marked as obsolete. 

e can only add open object attribute data to the end of the Get_ Attributes_ All and the Set_ 
Attributes_ All structure definitions via actions in CIP Special Interest Groups. 

e when extending an object, if the behavior of the existing public attributes or public services 
will change, the public revision of the object shall be incremented. 

e can add open or vendor specific services to the list of services. Deletion of open services is 
not allowed. Open services can be obsoleted, but obsoleted services shall still be shown in 
the object definition and marked as obsolete. 


4-9.2.1 Vendor-specific Extensions 


If you want to add attributes and/or services to an existing object to extend its functionality, 
and you want only your users to have access to the extension, then 
create a vendor-—specific extension. 


Important: Be sure to publish your vendor-specific extension in some way for your users. If 
you don’t publish the extension, then it is of little value because your users cannot access the 
added capability produced by the extension. 
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If you want other CIP participants to standardize on your extension, then 
propose an open extension (see Section 4-9.2.2) to the ODVA/CI organizations and 
wait for approval. 


Regardless of whether you choose to keep the extension vendor-specific or propose it as an 
open extension, the process for defining an extension is the same. 


Use the following example to examine the necessary steps for creating a vendor-specific, 
extension. 


4-9.2.1.1 Example 


For example purposes, assume you have a Widget Object, which is an existing open object that 
has two Class attributes and three Instance Attributes. 


Table 4-9.7 Class Attributes 


Number | Access Name Data Type Description of Semantics of 
Rule Attribute Values 
1 Revision UINT Revision of this 
object 
2 Max Instance UINT Maximum Instance 
Number 


Table 4-9.8 Instance Attributes 


Number | Access Name Data Type Description of Semantics of 
Rule Attribute Values 


1 Number of USINT Number supported 
ica in this el 
2 [set | Output Value BOOL = off; 1 =on 


3 Get Status UINT Current status a 
this object instance 


This object supports these Common Services: 


e Get_Attributes_All 
e Set_Attributes_All 


These services specify the following attributes: 


Table 4-9.9 Attributes Specified by Object Services 


Service Attributes 
Get_Attributes_All 1,2,3 
Set_Attributes_ All 2 


In addition to Common Services, the Widget Object in this example supports these Object 
Specific Services: 


e Upload_Widget_Attributes_All 
e Download_Widget_Attributes_All 
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The current capability of the Widget Object closely matches the function of your product. 
However, it does not completely support your desired implementation. You want to extend the 
object and then publish the extension for your users. 


For example, this hypothetical device requires the instance attributes Output Value, Status, and 
Number of Attributes, but needs an additional attribute specifying Input Value, which you 
would like to publish to your users. 


To extend the existing Widget Object to include the proprietary Input Value attribute: 


1. Add an attribute(s): Because this is a vendor specific attribute it needs to be in the vendor 
specific attribute value range. In this example, 100 has been chosen as the attribute number. 
The new list of Instance Attributes looks like this: 


Table 4-9.10 Instance Attributes for Extended Widget Object 


Number | Access Name Data Type Description of Semantics of 
Rule Attribute Values 


1 Get Number of USINT 
attributes 
2 Output Value | BOOL 


100 Set Input Value BOOL 0 = off; 1 = on 


2. Because this attribute is a vendor specific attribute the Set_Attributes_All and 
Get_Attributes_All service definitions are not changed (vendor specific attributes are not 
included in Set_Attributes_All and Get_Attributes_All). 

3. Add to list of object specific services, if necessary. 

4. Specify the new behavior with a new version of the State Transition Diagram and 
necessary text. 


4-9.2.1.2 Implementing a Vendor-specific Extension 


Whether adding vendor-specific attributes that are published for your users or proposed as a 
standard, you must plan for differences in: 


e Revisions 
e Get_Attributes_All service response 
e Set_Attributes_All service request 


4-9.2.1.2.1 Revisions 


Every object has a Class Attribute called “Revision.” The Revision of an object specifies the 
interface to that object, which encompasses all of the items in the object specification, 
including services, attributes, connections and behavior. 


If the value of the Revision attribute is 01, then support of the Revision attribute is OPTIONAL 
in the object’s implementation. If the value is greater than 01, then support of the Revision 
attribute is REQUIRED. 
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4-9.2.2 


Table 4-9.11 Class Attributes 
Number | Access Name Data Type Description of Semantics of 
Rule Attribute Values 
1 Get Revision UINT Revision of this 
object 


2 Get Max Instance UINT Maximum Instance 
Number 


Important: If you extend an object in a Server device but not in a potential Client, then the 
Revision of the object in the Server device is different from the revision expected by the Client. 
As a result, the Client will not recognize the extension, and will not implement its new 
behavior. 


To remedy this situation, you must document differences between the original object definition 
and the revised object definition. You may either: 


e Update the Client; or 


e Provide for the difference in revisions by allowing the Client to process error codes from the 
Server. You can program the Client to do one of the following: 


e Report the revision mismatch with an error handler that verifies the object revision; or 


e Determine the revision of the Server’s object with an error handler that also performs 
special-case processing. 


Important: The Revision class attribute is not the revision of an implementation (which is 
reflected in the Identity Object, Minor/Major revision status bits), but the revision of the open 
object definition. 


If you want to specify a revision of the vendor-specific object definition, we recommend 
defining a “vendor-specific revision” class attribute in the vendor—specific address range. 


The unrecognized attributes are either critical or non-critical to the behavior of the object. 


Table 4-9.12 Unrecognized Attribute Handling 


If the unrecognized Then 


attributes are 


Critical Processing the service results in an error. Client must be 
prepared to process the error. 

Non-critical the Server processes only the open attributes and ignores the 
vendor-specific attributes (which are initialized to default 
values). 


Open Extensions 


If you want to add attributes and/or services to an existing object to extend its functionality, 
and you want this extension to be standardized, then create an open extension in the same way 
you would a vendor-specific extension. See Steps 1 through 4 in Section 4-9.2.1.1, Example, 
and adhere to the following exceptions: 


e Propose the use of “Open” attributes using the open ID range instead of “Vendor-specific.” 
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e Submit the extension to ODVA/CI for approval 


Important: You cannot ship product based on your proposed extension until it is approved. 


4-9.3 Defining a New Object 


When defining a new object, either vendor-—specific or open, follow these general guidelines: 


e Break large objects into smaller objects: For example, break a “Controller” into “Data 
Table”, which can be read and written, and “Program”, which can be edited. 

e Avoid multiple interdependencies: Don’t break an object into multiple objects if this 
creates many interdependencies. Keep things that are tightly coupled in one object. 

e Hide some information: Hide those aspects that are not important to the object being 
specified. For example, if you can store a set of data as an array or in a linked list, don’t 
specify one or the other. Leave the set of data as “data storage”. 

e Do not hide important semantics: Don’t hide aspects that are important to the object being 
specified. For example, don’t write a value to a special location to cause a mode change. 
Use an interface that allows you to clearly state the desired action. 

e Generalize: Ask, “If product A needs an object from product B, will it also be needed in 
product C? If this is a possibility, how can I define the object so that it is also useful in 
product C?” 

e Provide for expansion: When possible, use variable length fields. You can extend fields in 
the future to handle cases not considered today. 


Important: It is preferable to extend an existing object than to define a new one. Fewer 
larger objects are more convenient than a proliferation of smaller objects that have 
similarities. 


In addition, use the numeric value itself instead of encoding the numeric value into a smaller 
number of bits, so that “unencodable” values become necessary in the future. 


e Be clear: Keep all statements, references and terms as clear and obvious as possible by 
using meaningful names. Don’t add complexity where not needed. 

e Make an object widely applicable: Make sure the object is useful in a wide range of 
products (i.e., from a proximity sensor to a motor starter). 


4-9.3.1 Vendor-specific 


If you want your CIP—compatible product to perform a function that existing open objects 
cannot implement, then you may define a Vendor-—specific Object within the appropriate 
address ranges. See Table 4-9.13. 


Table 4-9.13 Vendor-specific Object Address Ranges 


Type Range Quantity 

64h ex - C7hex 100 
Class ID 

300hex - 4FFhex 512 

64hex - C7hex 100 
Attribute ID — Vendor-Specific 300hex - 4FFhex 512 

900hex - CFFhex 1024 
Service Code — Vendor-—Specific 32hex - 4Ahex 25 
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Service Code — Object—Specific 4Bhex - ©3hex 25 


You may choose to create a vendor—specific object for one or more of the following reasons: 


e You want to create a device that has a function outside the realm of existing objects. 
e An existing product does not fit the function of existing objects. 
e You want to create an object that has proprietary attributes and behavior. 


Defining vendor-specific objects within specified Class ID, Attribute ID, and Service Code 
values has the following advantages and disadvantages: 


Table 4-9.14 Advantages and Disadvantages of Vendor-specific Objects 


Advantages Disadvantages 


Vendor controls the object The vendor must manage the dissemination of the object 


definition to other parties. 


Innovation not stifled or slowed The Client must verify that the target device is of the 
by standards process. vendor type that includes this new object definition. 


4-9.3.2 Open 


If you think a defined object and its behavior should be standardized, then propose an object 
specification with the Class Code and attribute IDs in the CIP Open address ranges to 
ODVA/CI. Also, specify common services used. See Table 4-9.15. 


Table 4-9.15 Open Address Ranges 


Type Range Quantity 


00 - 63hex 100 
Class ID 

FOhex - 2FFhex | 528 

00 - 63hex 100 


Attribute ID 100hex - 2FFhex | 512 


500pex - 8FFhex | 1024 


Service Code — Open 00 - 31pex 50 


You may follow the object template used in this chapter as well as the objects defined in 
Chapter 5, CIP Object Library. This template includes: 


e Class code in open range 

e Description of the object 

e Class attributes 

e Instance attributes 

e Common services supported 

e Object—specific services supported 
e Connections 

e Behavior 


Submit the object proposal to one of the Joint Special Interest Groups (JSIGs) in ODVA/CI for 
approval. 
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4-9.4 New Common Service 


If you want to define a new service that extends the current list of CIP Common Services, 
propose the service (in the open service code range) to ODVA/CI. 
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Object Specifications 


Using the format previously defined, the objects listed in Table 5-1.1 are specified in this 
object library. You can also use this table as a quick reference to objects and their 
corresponding class codes. 


Table 5-1.1 Object Specifications in the CIP Object Library 


Code 

31hex | S-Analog Sensor Object 5-277 
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Class For information about this Object: Go to page: 
Code 

32hex | S-Analog Actuator Object 5-310 

33hex | S-Single Stage Controller Object 5-318 

34hex | S-Gas Calibration Object 5-338 

35hex | Trip Point Object 5-344 

N/A Drive Data Object 5-350 

37hex | File Object 5-351 

38hex | S-Partial Pressure Object 5-368 

39hex | Safety Supervisor Object See Chapter 5 of Volume 5, CIP Safety 

3Ahex | Safety Validator Object See Chapter 5 of Volume 5, CIP Safety 


3Bhex | Safety Discrete Output Point Object See Chapter 5 of Volume 5, CIP Safety 
3Chex | Safety Discrete Output Group Object | See Chapter 5 of Volume 5, CIP Safety 
3Dhex | Safety Discrete Input Point Object See Chapter 5 of Volume 5, CIP Safety 
3Ehex | Safety Discrete Input Group Object See Chapter 5 of Volume 5, CIP Safety 
3Fhex | Safety Dual Channel Output Object See Chapter 5 of Volume 5, CIP Safety 


40hex | S-Sensor Calibration Object 5-379 
Alhex | Event Log Object 5-385 
42 hex | Motion Axis Object 5-403 
43 hex | Time Sync Object 5-539 
44 hex | Modbus Object See Chapter 5 of Volume 7, Integration of Modbus Devices into the 
CIP Architecture 
FOhex | ControlNet Object See Chapter 5 of Volume 4, ControlNet Adaptation of CIP 
Fihex | ControlNet Keeper Object See Chapter 5 of Volume 4, ControlNet Adaptation of CIP 
F2hex | ControlNet Scheduling Object See Chapter 5 of Volume 4, ControlNet Adaptation of CIP 
F3hex | Connection Configuration Object 5-556 
F4hex _ | Port Object See Volume 1, Chapter 3 
F5hex | TCP/IP Interface Object See Chapter 5 of Volume 2, EtherNet/IP Adaptation of CIP 
F6hex _ | Ethernet Link Object See Chapter 5 of Volume 2, EtherNet/IP Adaptation of CIP 
F7hex | CompoNet Link See Chapter 5 of Volume 6, CompoNet Adaptation of CIP 
F8hex | CompoNet Repeater See Chapter 5 of Volume 6, CompoNet Adaptation of CIP 
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5-2 Identity Object 


Class Code: 01 Hex 
This object provides identification of and general information about the device. The Identity 
Object shall be present in all CIP products. 


If autonomous components of a device exist, use multiple instances of the Identity Object. 


5-2.1 Class Attributes 


Table 5-2.1 Identity Object Class Attributes 


Need in Description of Semantics of Values 
Implementation | Rule Attribute 


This class attribute is optional and is described in Chapter 4 of this specification. 


Conditional Get Max UINT Maximum instance The largest instance 
Instance number of an object number of a created 
currently created in this | object at this class 
class level of the hierarchy level. 
device. 


3 thru 7 | These class attributes are optional and are described in Chapter 4 of this specification. 
1 If the possibility exists that multiple subcomponents will be identified using multiple instances of the Identity 
Object, then this attribute is required to be supported. The numerically lowest available integer shall be 
assigned as the Instance Identifier of a newly created Identity Object Instance. 


5-2.2 Instance Attributes 


Table 5-2.2 Identity Object Instance Attributes 


Attr Needin | Access | NV Name Data Description of Attribute | Semantics of Values 
ID Implem Rule 


Type 
1 Required Get Vendor ID UINT Identification of each 
vendor by number 


See “Semantics” 


section 
2 | Required Device Type UINT Indication of general type | See “Semantics” 
of product section 


3 | Required Product Code UINT Identification of a See “Semantics” 
particular product of an section 
individual vendor 


mee 

Get Revision STRUCT | Revision of the item the 
of: Identity Object represents 

Get 


4 | Required 

Major Revision USINT See “Semantics” 

Minor Revision USINT See “Semantics” 

5 | Required Status WORD Summary status of device | See “Semantics” 
section 

6 | Required Get Serial Number UDINT Serial number of device See “Semantics” 
section 

7 | Required Get Product Name SHORT__ | Human readable See “Semantics” 
STRING _| identification section 
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Attr Needin | Access | NV Name Data Description of Attribute | Semantics of Values 
ID Implem Rule Type 
8 | Optional Get State USINT Present state of the device | 0 = Nonexistent 
as represented by the state | 1 = Device Self 
transition diagram Testing 
2 = Standby 
3 = Operational 
4 = Major 
Recoverable Fault 
5 = Major 
Unrecoverable Fault 
6 — 254 = Reserved 
255 = Default for 
Get_Attributes_All 
service 
9 | Optional Get Configuration UINT Contents identify See “Semantics” 
Consistency Value configuration of device section 
10 | Optional Get/Se Heartbeat Interval USINT The nominal interval The default value is 0. 
t between heartbeat Zero disables 
messages in seconds. transmission of the 
heartbeat message. 
11 | Optional Set NV | Active Language STRUCT | Currently active language | Based on ISO 639-2/T. 
of for the device. See Appendix C-4, 
The language! field from | STRINGI data type, 
the STRINGI data type. _| anguage1, language2, 
The language? field from ee eee 
the STRINGI data type. P 
section. 
The language3 field from 
the STRINGI data type. 
12 | Optional Get V___| Supported Language |ARRAY | List of languages See Appendix C-4, 
List of supported by character STRINGI data type, 
STRUCT | Strings of data type languagel, language2, 
of STRINGI within the and language3 fields. 
device. The array index of the 
USINT _ |The language] field from _| !anguage is used within 
the STRINGI data type. the International String 
USINT The language2 field from ae ema 
the STRINGI data type. |? 
USINT The language3 field from 
the STRINGI data type. 
13 | Optional Get NV | International Product |STRINGI | The names of the product 
Name in various languages 
14 | Optional Set Semaphore Struct of | Access Synchronization See “Semantics” 
Semaphore section 
Client Electronic Key | UINT Vendor Number Default: All zero 
UDINT __ | Client Serial Number values 
Semaphore Timer ITIME Millisecond Timer Timer valid range 100 
thru 32767 
15 | Optional Set NV | Assigned_Name STRINGI | User assigned name. See “Semantics” 
section 
16 | Optional Set NV | Assigned_Description |STRINGI | User assigned description. | See “Semantics” 
section 
17. | Optional Set NV | Geographic_Location |STRINGI | User assigned location. See “Semantics” 


section 
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Attr Needin | Access | NV Name Data Description of Attribute | Semantics of Values 
ID Implem Rule Type 


18 | Conditional’ Modbus Identity Info See Volume 7, Integration of Modbus Devices into the CIP 
Architecture (Chapter 5) 


1 This attribute is not allowed if the device is not a Modbus device. If the device is a Modbus device, see Volume 7. 


The following Instance Attributes are used to identify with certainty the appropriate device 
targeted by a connection originator: 

e Vendor ID 

e Device Type 

e Product Code 

e Revision 

This collection of attributes, when kept by the connection originator, is often referred to as a 
device’s “electronic key”. 


5-2.2.1 Semantics 


5-2.2.1.1 Vendor ID 
Vendor IDs are managed by the Open DeviceNet Vendor Association, Inc. (ODVA) and 
ControlNet International (CI). The value zero is not valid. 


5-2.2.1.2 Device Type 


The list of device types is managed by ODVA and CI. It is used to identify the device profile 
that a particular product is using. Device profiles define minimum requirements a device must 
implement as well as common options. 


A listing of the presently defined Device Types can be found in Chapter 6-1. 
5-2.2.1.3 Product Code 


The vendor assigned Product Code identifies a particular product within a device type. Each 
vendor assigns this code to each of its products. The Product Code typically maps to one or 
more catalog/model numbers. Products shall have different codes if their configuration and/or 
runtime options are different. Such devices present a different logical view to the network. On 
the other hand for example, two products that are the same except for their color or mounting 
feet are the same logically and may share the same product code. 


The value zero is not valid. 


5-2.2.1.4 Revision 


The Revision attribute, which consists of Major and Minor Revisions, identifies the Revision of 
the item the Identity Object is representing. 


The value zero is not valid for either the Major and Minor Revision fields. 


The Major and Minor Revision are typically displayed as major.minor. Minor revisions shall 
be displayed as three digits with leading zeros as necessary. The Major Revision attribute is 
limited to 7 bits. The eighth bit is reserved by CIP and must have a default value of zero. 


The major revision should be incremented by the vendor when there is a significant change to 
the ‘fit, form, or function’ of the product. Any changes that affect the configuration choices 
available to the user (and therefore the Electronic Data Sheet) require incrementing the major 
revision. 
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The minor revision is typically used to identify changes in a product that do not affect user 
configuration choices. For example, bug fixes, hardware component change, labeling change, 
etc. Changes in minor revision are not used by a configuration tool to match a device with an 
Electronic Data Sheet. 


5-2.2.1.5 Status 


This attribute represents the current status of the entire device. Its value changes as the state of 
the device changes. The Status attribute is a WORD, with the following bit definitions: 


Table 5-2.3 Bit Definitions for Status Instance Attribute of Identity Object 


Bit (s) Called Definition 
0 Owned TRUE indicates the device (or an object within the device) has an owner. Within the 
Master/Slave paradigm the setting of this bit means that the Predefined Master/Slave 
Connection Set has been allocated to a master. Outside the Master/Slave paradigm the 
meaning of this bit is TBD. 


1 _————— | Reserved, shall be 0 


2 Configured TRUE indicates the application of the device has been configured to do something different 
than the “out—of—box” default. This shall not include configuration of the communications. 
3 ae Reserved, shall be 0 


Extended Device Vendor-specific or as defined by table below. The EDS shall indicate if the device follows 
Status the public definition for these bits using the DeviceStatusAssembly keyword in the [Device] 
section of the EDS. If these bits are vendor specific then they shall be enumerated in the EDS 
using the Assembly and Parameter sections. 


Minor Recoverable | TRUE indicates the device detected a problem with itself, which is thought to be recoverable. 
Fault The problem does not cause the device to go into one of the faulted states. See Behavior 
section. 

Minor Unrecoverable | TRUE indicates the device detected a problem with itself, which is thought to be 

Fault unrecoverable. The problem does not cause the device to go into one of the faulted states. See 
Behavior section. 


10 Major Recoverable TRUE indicates the device detected a problem with itself, which caused the device to go into 
Fault the “Major Recoverable Fault” state. See Behavior section. 
11 Major Unrecoverable | TRUE indicates the device detected a problem with itself, which caused the device to go into 
Fault the “Major Unrecoverable Fault” state. See Behavior section. 
12-15 Reserved, shall be 0 


Table 5-2.4 Bit Definitions for Extended Device Status Field 


Bits 4 - 7: Extended Device Status Description 
0000 Self-Testing or Unknown 
0001 Firmware Update in Progress 
0010 At least one faulted I/O connection 
0011 No I/O connections established 
0100 Non-Volatile Configuration bad 
0101 Major Fault — either bit 10 or bit 11 is true (1) 
0110 At least one I/O connection in run mode 
0111 At least one I/O connection established, all in idle mode 
1000 Reserved, shall be 0 
1001 


1010 thu 1111 Vendor/Product specific 


The values of the following Status bits indicate the state of the device: 
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e Bit 8: Minor Recoverable Fault 

e Bit 9: Minor Unrecoverable Fault 
e Bit 10: Major Recoverable Fault 

e Bit 11: Major Unrecoverable Fault 


Note that the events that constitute a fault (recoverable or unrecoverable) are to be determined 

by the product developer. The following examples should help to define the various types of 

faults: 

e Minor Recoverable Fault - an analog input device is sensing an input that exceeds the 
configured maximum input value. 

e Minor Unrecoverable Fault - the device’s battery backed RAM requires a battery 
replacement. The device will continue to function properly until the first time power is 
cycled. 


e Major Recoverable Fault - the device’s configuration is incorrect or incomplete. 
e Major Unrecoverable Fault - the device failed its ROM checksum process. 


Table 5-2.5 Minor/Major Bit Definitions 


Non-recoverable 
Minor (no state change) Bit 9 


Major (state changes) Bit 10 Bit 11 


The event that sets the bit also causes a state change. See the State Transition Diagram in 
Figure 5-2.1. 


5-2.2.1.6 Serial Number 


This attribute is a number used in conjunction with the Vendor ID to form a unique identifier 
for each device on any CIP network. Each vendor is responsible for guaranteeing the 
uniqueness of the serial number across all of its devices. 


5-2.2.1.7 Product Name 


This text string should represent a short description of the product/product family represented 
by the product code in attribute 3. The same product code may have a variety of product name 
strings. The maximum number of characters in this string is 32. 


5-2.2.1.8 State 


This attribute is an indication of the present state of the device. Note that the nature of a Major 
Unrecoverable Fault could be such that it may not be accurately reflected by the State attribute. 


5-2.2.1.9 Configuration Consistency Value 


A product may automatically modify the Configuration Consistency Value whenever any non- 
volatile attribute is altered. A client node may, or may not, compare this value to a value 
within its own memory prior to system operation. The client node’s behavior, upon detection 
of a mismatch, is vendor specific. The Configuration Consistency Value may be a CRC, 
incrementing count or any other mechanism. The only requirement is that if the configuration 
changes, the Configuration Consistency Value shall be different to reflect the change. 


5-2.2.1.10 Heartbeat Interval 
This attribute sets the nominal interval between production of optional heartbeat messages. 
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Identity Object, Class Code: 01p¢x 


Active Language 


If this attribute is supported, all character strings within the device of data type STRING or 
SHORT_STRING shall follow this setting. Only languages, which are supported by the ISO- 
8859-1 character set, can be represented in these strings; if the Active Language is set to a 
language, which cannot be represented in ISO-8859-1, the device shall return the string in the 
default language. Any other object attributes, (class or instance level) which set the language 
for strings of these data types, shall not be supported (i.e. the class level Native Language 
attribute of the Parameter and Parameter Group objects). 


Semaphore 


This optional attribute provides a semaphore for client access synchronization to the entire 
device. This is a volatile attribute whose value after a reset or power-up is always zero. This 
attribute consists of two components, an electronic key of the client process and a semaphore 
timer. 


The Client Electronic Key is composed of the client’s CIP vendor number and the client’s 
device serial number. 


The Semaphore Timer is a millisecond timer, that when non-zero, counts down to zero. When 
the Semaphore Timer reaches the value zero, the Semaphore attribute is set to all zeros. The 
valid range of values for the timer portion of this attribute in a Set_Attribute_Single’s service 
data is 100 milliseconds through 32767 milliseconds. 


The Semaphore attribute can be read at any time. The value reported will be the current content 
of the Semaphore attribute, including the real-time (actual) timer value. 


The Semaphore attribute’s Semaphore Timer component operates at the base time resolution of 
the device. Therefore, if the time base of the device is greater than a 1 millisecond resolution, 
the time value accepted by the attribute shall be rounded up to the next timer increment 
appropriate for the device. 


When a Set_Attribute_Single service is directed to this attribute, the attribute will be set to the 
service data if either of the following is true: 
e The current value in the attribute is zero 


e The Electronic Key portion of the service data matches the Electronic Key portion of the 
attribute data 


The following error responses are defined for the Semaphore attribute: 


Semaphore Attribute Error Responses 


Error Additional Error Response Interpretation 
Code Code 
0x02 None Resource Unavailable — The Client Electronic Key portion of the Semaphore 


attribute was non-zero and did not match the Client Electronic Key portion of the 
Set Attribute service data. This error response indicates that the Semaphore has 
been previously set by a different client process and is not available at the present 
time. 


0x09 None Invalid Attribute Value — The value specified for the timer portion of the attribute 
value was less than 100 milliseconds. 


0x10 None Device State Conflict — the device is currently in a state that does not allow the 
setting of the Semaphore attribute. This is a device specific behavior and shall be 
documented by the vendor. 
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5-2.2.1.13 Assigned_Name 


This text string represents the user assigned name of the device. 


5-2.2.1.14 Assigned_Description 


This text string represents a user assigned description of the device and may also describe its 
function. 


5-2.2.1.15 Geographic_Location 


5-2.3 


5-2.3.1 


This text string represents the physical location of the device as provided by the user. 


Common Services 


The Identity Object provides the following Common Services: 


Table 5-2.6 Identity Object Common Services 


Code Service Name Description of Service 
OEhex Returns the contents of the specified attribute. 
OShex Invokes the Reset service for the device. 


Olhex | Optional Conditional | Get_Attributes_All Returns a predefined listing of this objects 
attributes (See the Get_Attributes_All Response 
definition below) 

10hex |n/a Conditional Set_Attribute_Single Modifies an attribute (Required if Heartbeat 
interval is defined) 

11hex | Optional n/a Find_Next_Object_Instance | Causes the specified Class to search for and return 
a list of instance IDs of existing instances of the 
Identity object. 

18hex Returns the content of a selected member of an 
attribute. 


1 The Get_Attribute_Single service is REQUIRED if any Class attributes are implemented. 


2 The Get_Member service is required if any attributes with the International String (STRINGI) data type are 
implemented. 


See Appendix A for definition of these services 


Reset Service 

When the Identity Object receives a Reset request, it: 

e determines if it can provide the type of reset requested 
e responds to the request 

e attempts to perform the type of reset requested 


The Reset common service has the following object-specific parameter: 


Table 5-2.7 Reset Service Parameter 


Name Type Description of Request Parameters Semantics of Values 
Type USINT _ | Type of Reset See Table below. 


The parameter for the Reset common service has the following bit specifications: 
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Table 5-2.8 Reset Service Parameter Values 


Value: Type of Reset: 


0 Emulate as closely as possible cycling power on the item the Identity Object represents. This value is 
the default if this parameter is omitted. 


1 Return as closely as possible to the factory default configuration, then emulate cycling power as 
closely as possible. 


2 Return as closely as possible to the out-of-box configuration with the exception of communication 
link parameters and emulate cycling power as closely as possible. The communication link 
parameters that are to be preserved are defined by each network type. See the Reset service of the 
network specific link object(s) for complete information. 


3-99 _ | Reserved by CIP 
100-199 | Vendor specific 
200 - 255 | Reserved by CIP 


Get_Attributes_All Response 


At the Class level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows: 


Table 5-2.9 Get_Attributes_All Response —Class Level 


Byte Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
0 Revision (low byte) Default = 1 
Revision (high byte) Default = 0 
Max Instance (low byte) Default = 1 
Max Instance (high byte) Default = 0 
Max ID Number of Class Attributes (low byte) Default = 0 
Max ID Number of Class Attributes (high byte) Default = 0 
Max ID Number of Instance Attributes (low byte) Default = 0 


AypuytR]wlrMmyr 


7 Max ID Number of Instance Attributes (high byte) Default = 0 


Important: Insert default values for all unsupported attributes. 


At the Instance level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows: 


Table 5-2.10 Get_Attributes_All Response — Instance Level 


Byte Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
0 Vendor (low byte) 
Vendor (high byte) 
Device Type (low byte) 
Device Type (high byte) 
Product Code (low byte) 
Product Code (high byte) 
Major Revision 
Minor Revision 


Status (low byte) 


OlOI NI Da!) oy] R] wT nNnir 


Status (high byte) 


PR 
Oo 


Serial Number (low byte) 
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Byte Bit 7 Bit 6 Bit5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 


11 Serial Number 
12 Serial Number 
13 Serial Number (high byte) 
14 Product Name length 
15 Product Name (1st character) [See Note 1 below] 
16 Product Name (2nd character) 
n Product Name (last character) 
nt+1 State, Default = 255 
n+2 Configuration Consistency Value, Default = 0 
n+4 Heartbeat Interval, Default = 0 
n+5 Active Language, language! field value 
n+6 Active Language, language2 field value 
n+7 Active Language, language3 field value 
n+8 Supported Language List, Member 1, language1 field value 
n+9 Supported Language List, Member 1, language2 field value 
n+10 Supported Language List, Member 1, language3 field value 
n+11 Supported Language List, Member 2, language1 field value 
n+12 Supported Language List, Member 2, language1 field value 
n+13 Supported Language List, Member 2, language1 field value 


where m=number of members in Supported Language List 
and n=Product name Length+14 
then j = n+8+((m-1)*3) 


j International Product Name (first octet) [See Note 1 below] 
jt1 International Product Name (second octet) 
k International Product Name (last octet) 


Note 1: This is a variable length field. 


Important: Insert default values for all unsupported attributes. 


Important: Because the length of the name is not known before issuing the Get_Attributes_All 
service request, allow enough memory space to store a response up to 32 characters in length. 
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5-2.4 Object—specific Services 
The Identity Object provides no Object—specific services. 
5-2.5 Object-specific General and Extended Status Codes 
Table 5-2.11 Object-specific General and Extended Status Codes 
General 8-bit Associated Status Name Description of Status 
Status Code | Extended Status 
(in hex) Codes 


00 - CF _—— | General Codes Defined in Appendix B 
00 — EE Po Reserved Extended Status Codes 
FO - FE Vendor Specific Vendor specific Extended Codes 


Sa ae Used with all General Codes when required and no other 
Extended Code is assigned 
DO | =| Hardware Diagnostic | DeviceSelf Testing and Hardware Diagnostic Conditions 
a ae Checksum (or CRC) error — Code space/ROM — Boot 
section 
a ae Checksum (or CRC) error — Code space/ROM — 
Application section 
a ee ee Checksum (or CRC) error — NV (flash/EEPROM) memory 
a ee ee Invalid non-volatile (NV) memory — Configuration bad 
Invalid non-volatile (NV) memory — No configuration 
established 
a RAM memory bad — The RAM memory in the device was 
determined to be experiencing inoperative cells 
| oy ROM/Flash Memory bad 
| 08 | | Flash/EEPROM (NV) Memory Bad 
a re Interconnect wiring error / signal path problem 
| oA Power problem — Over current 
| =—oBsi‘im;s Power problem — Over voltage 
| oc | Power problem — Under voltage 
a Internal Sensor problem 
ee ee System Clock Fault 
a ae ieee Hardware configuration does not match NV configuration 
a es Watchdog Disabled/Idle 
a er Watchdog Timer Expired 
12 Device over temperature 
a ae Ambient temperature outside of operating limits 
oo es Vendor specific Extended Codes 
ed Used with all General Codes when required and no other 
Extended Code is assigned 
D1 


Power Applied 


SS Device Status/States Device Status Events and Conditions 
ee 


Device Reset 
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General 8-bit Associated Status Name Description of Status 
Status Code | Extended Status 
(in hex) Codes 


0 Device Power Loss 
0. 
0 


re 

[| Activated 

nh Deactivated 

P Enter Self-Test State 

0 Po Enter Standby State 

nn) Enter Operational State 

CS Non-Specific Minor Recoverable Fault Detected 
Po Non-Specific Minor Unrecoverable Fault Detected 
Po Non-Specific Major Recoverable Fault Detected 
a Non-Specific Major Unrecoverable Fault Detected 
a Fault(s) corrected 

| «| CCV Changed 

es 


0 Heartbeat Interval Changed 


FO - FE Vendor Specific Vendor Specific 


Used with all General Codes when required and no other 
Extended Code is assigned 
Object Specific : 
D2 -—EF (eee Ganaral Gade Reserved by CIP — Not yet assigned 


A vendor specific error has been encountered. The 
Additional Code Field of the Error Response defines the 
FO —FF Vendor Specific particular error encountered. Use of this General Error 
General Codes Code should only be performed when none of the Error 
Codes presented in this table or within an Object Class 
definition accurately reflect the error. 
All Extended Status Codes are available for association 
Extended Codes with each Vendor Specific General Code 


5-2.6 Behavior 


The behavior of the Identity Object is illustrated in the State Transition Diagram (STD) in 
Figure 5-2.1. This STD associates the state of the device with the status reported by the Status 
Attribute with the state of the Module Status LED. 


3 
4 
5 
7 
A 
C 
E, 
F 
F 


F 


Important: A device may not be able to communicate in the Major Unrecoverable Fault state. 
Therefore, it might not be able to report a Major Unrecoverable Fault. It will not process a 
Reset service. The only exit from a Major Unrecoverable Fault is to cycle power. 


The Identity object triggers production of heartbeat messages as defined by the underlying 
network when: 


e the interval configured in the Heartbeat Interval Attribute has passed since the last 
heartbeat message. 

e the Heartbeat message contents change, at a maximum rate of one “data changed” heartbeat 
message per second. 
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The Heartbeat Interval value shall be saved as a Non-Volatile attribute. Heartbeat messages are 
only triggered after the device has successfully completed the network access state machine 
and is online. Not all networks support sending the Heartbeat message. 


Figure 5-2.1 State Transition Diagram for Identity Object 


Nonexistent 


Device Self Testing 
Flashing Red/Green 


Passed T ests 


Power Loss (from 
any state) 


Identity Object Reset Service 


(from any state except Major 
Unrecoverable Fault) 


Fault corrected 
Standby 


Flashing Green 


Activated 


Deactivated 


Operational 


Solid Green y 


Major Major 
Recoverable Unrecoverable 
Fault Fault 


Major Major 


Recoverable Unrecoverable LED = Module Status 


Fault Fault 
Flashing Red y Solid Red y 


The STD for the Identity object contains the following events: 


e Power Applied - the device is powered up 

e Passed Tests - the device has successfully passed all self tests 

e Activated - the device’s configuration is valid and the application for which the device was 
designed is now capable of executing (communications channels may or may not yet be 
established) 

e Deactivated - the device’s configuration is no longer valid and the application for which 
the device was designed is no longer capable of executing (communication channels may 
or may not still be established) 

e Minor fault - a fault classified as either a minor unrecoverable fault or a minor recoverable 
fault has occurred 

e Major recoverable fault - an event classified as Major Recoverable Fault has occurred 

e Major unrecoverable fault - an event classified as a Major Unrecoverable Fault has 
occurred 
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Table 5-2.12 State Event Matrix for Identity Object 


Event 


Power Loss 


Power Applied 


Failed Tests 


Passed Tests 


Deactivated 


Activated 


Major Recoverable 
Fault 

Major 
Unrecoverable Fault 


Minor 
Recoverable Fault 


Minor 
Unrecoverable 
Fault 


Fault 
Corrected 


Reset 


Module 
Status LED 


Nonexistent | Device Self Testing Standby Operational Major Major 
Unrecoverable | Recoverable 
Fault Fault 
Not Transition to Transition to Transition to Transition to Transition to 
Applicable Nonexistent Nonexistent Nonexistent Nonexistent Nonexistent 
Transition to Not Not Not Not 
Device Self Applicable Applicable Applicable plicable Applicable 
Testing 
Transition to Major Not Not No Not 
oo Unrecoverable Fault Applicable Applicable Applicable Applicable 
Transition to Standby | Not Not ni Not 
oo Applicable Applicable Applicable Applicable 


Ignore Event Ignore Event Transition to Standby | Ignore Event Ignore Event 
oo 

Ignore Event Transition to Ignore Event Ignore Event Ignore Event 
ee e Operational 
Not Not Transition to Major Transition to Major Ignore Event Ignore Event 
— =—= Recoverable Fault Recoverable Fault 

Transition to Major Transition to Major Ignore Event Ignore Event 

eae ee Unrecoverable Fault | Unrecoverable Fault 

Ignore Event eer | Event Ignore Event Ignore Event Ignore Event 
ae 


Ignore Event iain Event Ignore Event Ignore Event Ignore Event 


aati 


Not Transition to 


Standby 


ot 


inane noelistle ee 


Applicable 
Transition to Device | Transition to Device | Ignore Event 
Self Testing 


Transition to 


Device Self 


Applicable 
Restart Self Tests 
Tonite 
Testing 
al Flashing Red/Green Flashing Green Solid Green Solid Red Flashing Red 


Self Testing 


The SEM for the Identity object contains the following states: 


Nonexistent - the device is without power 

Device Self Testing - the device is executing its self tests 

Standby - the device needs commissioning due to an incorrect or incomplete configuration 
Operational - the device is operating in a fashion that is normal for the device 

Major Recoverable Fault - the device has experienced a fault that is believed to be 
recoverable 

Major Unrecoverable Fault - the device has experienced a fault that is believed to be 
unrecoverable 
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Message Router Object 
Class Code: 02 hex 


The Message Router Object provides a messaging connection point through which a Client 
may address a service to any object class or instance residing in the physical device. 


Class Attributes 


Table 5-3.1 Message Router Object Class Attributes 


Need in Access Name Data Description of 
Implementation | Rule Type Attribute 


1 thru 7 | These class attributes are optional and are described in Chapter 4 of this specification. 


Number Semantics of Values 


Instance Attributes 


Table 5-3.2 Message Router Object Instance Attributes 


Number Need in Access Name Data Description of Semantics of Values 
implementation | Rule Type Attribute 


1 Optional Get Object_list STRUCT | A list of supported | Structure with an array of 
of objects object class codes 
supported by the device 
Number UINT Number of The number of class codes 
supported classes in | in the classes array 
the classes array 
Classes ARRAY | List of supported The class codes supported 
of UINT | class codes by the device 
2 Optional Get Number Maximum number — | Count of the max number 
Available of connections of connections supported 
supported 
3 Optional Get Number UINT Number of Current count of the 
active connections number of connections 
currently used by allocated to system 
system components | communication 
4 Optional Active ARRAY |A list of the Array of system 


Connections | of: UINT | connection IDs of connection IDs 
the currently active 
connections 


Common Services 


The Message Router Object provides the following Common Services: 


Table 5-3.3 Message Router Common Services 


Need in Implementation Service Name 


Class 


Get_Attribute_Single 
Get_Attributes_All | Returns the contents of all attributes 


*The Get_Attribute_Single service is REQUIRED if any attributes are implemented. 


Service 
Code 


Description of Service 


Returns the contents of the specified attribute. 
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Get_Attributes_All Response 


At the Class level, the order of the attributes returned in the “Object/service specific reply data” 
portion of the Get_Attributes_All response is as follows: 


Table 5-3.4 Get_Attributes_All Service Data — Class Level 

0 Revision (low byte) Default = 1 

1 Revision (high byte) Default = 0 

2 Optional Attribute List : number of attributes (low byte) Default = 0 

3 Optional Attribute List : number of attributes (high byte) Default = 0 

4 Optional Attribute List : optional attribute #1 (low byte) 

5 Optional Attribute List : optional attribute #1 (high byte) 

n Optional Attribute List : optional attribute #m (low byte) 

n+1 Optional Attribute List : optional attribute #m (high byte) 

Optional Service List : number of services (low byte) Default = 0 
Optional Service List : number of services (high byte) Default = 0 


Optional Service List : optional service #1 (low byte) 


Optional Service List : optional service #m (low byte) 
Optional Service List : optional service #m (high byte) 
Max ID Number of Class Attributes (low byte) Default = 0 
Max ID Number of Class Attributes (high byte) Default = 0 
Max ID Number of Instance Attributes (low byte) Default = 0 
Max ID Number of Instance Attributes (high byte) Default = 0 


Important: If the class attribute ”Optional Attribute List” is not supported, the default value of 
zero is to be inserted into the response byte array and no optional attribute numbers will follow. 


Important: If the class attribute Optional Service List” is not supported, the default value of 
zero is to be inserted into the response byte array and no optional service numbers will follow. 


Important: Insert default values for all unsupported attributes. 


At the Instance level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows: 
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Message Router Object, Class Code: 024. 
Table 5-3.5 Get_Attributes_All Service Data — Instance Level 


0 Object_list : Number (low byte) Default = 0 


1 Object_list : Number (high byte) Default = 0 
2 Object_list : Class #1 (low byte) 
3 Object_list : Class #1 (high byte) 
n Object_list : Class #m (low byte) 
n+1 Object_list : Class #m (high byte) 


Number Available (low byte) Default = 0 
Number Available (high byte) Default = 0 
Number active (low byte) Default = 0 
Number active (high byte) Default = 0 
Active Connections #1 (low byte) 
Active Connections #1 (high byte) 


. Active Connections #m (low byte) 
; Active Connections #m (high byte) 
Important: Insert default values for all unsupported attributes. 


Important: If the Instance attribute ”Object_list” is not supported, the default value of zero is 
to be inserted into the response byte array and no Object_list class numbers will follow. 


Important: If the Instance attribute ”Number active” is not supported, the default value of zero 
is to be inserted into the response byte array and no Active Connection numbers will follow. 


Object—Specific Services 
The Message Router Object provides the following Object-specific services. 


Table 5-3.6 Object Specific Services 
Service Need in Implementation Feeaene| 
Code Class Instance Service Name Description of Service 


ABhex Optional n/a SymbolicTranslation | Provides a translation from a Symbolic Segment 
EPATH encoding to the equivalent Logical 
Segment EPATH encoding, if it exists 


Symbolic Translation 


The SymbolicTranslation object specific service provides a mechanism for a device, that has 
implemented Symbolic Segment representations of internal EPATH addresses, to translate 
those Symbolic Addresses encodings into their equivalent Logical Segment EPATH 
encodings. 


The service data of the SymbolicTranslation service shall be a single Symbolic Segment or 
ANSI Extended Symbol EPATH address. The response data shall be the equivalent Logical 
EPATH encoding. 
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Table 5-3.7 SymbolicTranslation Request Service Data Field Parameters 


Name Description of Service Parameter 
Symbolic A Symbolic Segment or ANSI Extended Symbol Segment to be translated 
Address 


Table 5-3.8 SymbolicTranslation Response Service Data Field Parameters 


Name Description of Service Parameter 
Logical A Logical Segment and optional Data Segment encoding representing the 
Address internal equivalent of the requested Symbolic Address 


Error | Extended Error Name Description 
Code Code 


0x20 0x00 Symbolic Path unknown The Symbolic EPATH is not recognized by the processing 
node 


0x01 Symbolic Path destination not The Symbolic EPATH, although recognized, is not presently 


assigned associated with a Logical EPATH equivalent. 


Symbolic Path segment error The symbol identifier or the symbol segment syntax was not 


understood by the processing node. 
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5-3.5 Behavior 


The Message Router Object receives explicit messages and performs the following functions: 


e interprets the Class Instance specified in a message 
e routes a service to the specified object 

e interprets services directed to it 

e routes a response to the correct service source 


5-3.5.1 Service Request 
Interpretation of the Class Instance is performed on every service received by the Message 
Router. 


Any Class Instance that cannot be interpreted by a device’s implementation of a Message 
Router will report the Object_Not_Found error. 


The service is then routed to a target object. 


5-3.5.2 Service Response 


All service responses are routed to the Explicit Messaging connection across which the service 
request was received. 
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DeviceNet Object 
Class Code: 03 hex 


The DeviceNet Object provides the configuration and status of a DeviceNet port. Each 
DeviceNet product must support one (and only one) DeviceNet object per physical connection 
to the DeviceNet communication link. 


See the Volume 3, DeviceNet Adaptation of CIP Common Specification for the definition of 
this object class. 
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5-5 Assembly Object 
Class Code: 04 hex 


The Assembly Object binds attributes of multiple objects, which allows data to or from each 
object to be sent or received over a single connection. Assembly objects can be used to bind 
input data or output data. The terms ”input” and ”output” are defined from the network’s point 
of view. An input will produce data on the network and an output will consume data from the 
network. 


Table 5-5.1 Revision History 


Assembly Class Description 
Revision 
00 Pre-release definition 
01 Initial release 
02 1. Class specific Service Codes 4Byex and 4Chex obsoleted 


Assembly objects instances can either be dynamic or static: 


e Dynamic: assemblies with member lists created and managed by the user. The member list 
can be altered by adding or deleting members. Dynamic assemblies shall be assigned 
instance Ids in the vendor specific range. 

e Static: assemblies with member lists defined by the device profile or by the manufacturer 
of the product. The Instance number, number of members, and member list are fixed. Static 
assemblies can usually be implemented entirely in ROM. 


Important: Instances of the Assembly Object are divided into the following address ranges to 
provide for extensions to device profiles. 


Table 5-5.2 Assembly Instance ID Ranges 


Range Meaning Quantity 


100000,., - FFFEFFFF.. 4,293,918,720 
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5-5.1 Class Attributes 


Table 5-5.3 Assembly Object Class Attributes 


Attribute Need in Access Name Data Type | Description of | Semantics of Values 
ID Implementation Rule Attribute 
1 


Conditional* Get Revision UINT Revision of The current value 
this object assigned to this 
attribute is two (02). 


2 thru 7 | These class attributes are optional and are described in Chapter 4 of this specification. 


*This attribute is REQUIRED if Instance Attribute 2 is supported, otherwise this attribute is OPTIONAL. 


5-5.2 Instance Attributes 


Table 5-5.4 Assembly Object Instance Attributes 


Attribute Need in Access Name Data Type | Description of | Semantics of Values 
ID Implementation Rule Attribute 


Conditional Get Number of UINT Required for 
Members in Dynamic Assembly 
List only 
2 Conditional Set for Member List ARRAY of | The member Required for 
Dynamic/ STRUCT: list is an array | Dynamic Assembly 
Get for of CIP paths only 
Static 


Member Data | UINT Size of Size in bits 
Description member data. 


Member Path Size of 
Size Member Path 


(in bytes). 


Member Path | Packed See Appendix 
EPATH C for the 
format of this 
field. 
3 Required Set Data ARRAY of 
BYTE 
4 Optional Get Size UINT Number of 
bytes in 
Attribute 3 
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5-5.3 Common Services 


The Assembly Object provides the following Common Services: 


Table 5-5.5 Assembly Object Common Services 


Need in Implementation 


Service Static Assembly Dynamic Assembly 


OEhex | Conditional’ | Required Required | Required Get_Attribute_ | Returns the contents of the 
Single specified attribute. 


O8hex | n/a n/a Required |n/a Create Instantiates an Assembly 
Object within a specified 
class. Response contains 
instance number. Dynamic 
assemblies shall be assigned 
instance Ids in the vendor 
specific range. 


Single 


O9hex | n/a n/a Optional? | Required Delete Deletes an Assembly Object 
and releases all associated 
resources. 


1Ahex | n/a n/a n/a Conditional’ | Insert_ Adds a member to the 
Member Assembly Member List. 

1Bhex | n/a n/a n/a Conditional* | Remove_ Removes a member from the 
Member Assembly Member List. 


18hex | n/a Optional n/a Optional Get_Member __| Returns a member from the 
Assembly Member List or 
Data attributes. 


19hex | n/a Optional n/a Optional Set_Member Modifies a member of the 
Assembly Member List or 
Data attributes. 


Required if Max Instance Class Attribute is implemented or Instance Attribute 2 (Member List). 


2 If you choose NOT to support the Set_Attribute_Single common service at the Instance level for a Dynamic 
Assembly, then your product shall support the Insert_Member and Remove_Member common services. 


3 At the class level this service deletes all existing Assembly instances. 


4 If you choose NOT to support the Insert_Member and Remove_Member common services at the Instance level 
for a Dynamic Assembly, then your product shall support the Set_Attribute_Single common service. 


See Appendix A for definition of these services 
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Object—specific Services 


The Assembly Object provides no Object-specific services. The following Object-specific 
service codes have been obsoleted: 


Table 5-5.6 Assembly Object Obsolete Object-Specific Services 


Obsoleted Need in Implementation 


/a n/a n/a n/a 


n 


Service 


Code 


Description of Service 
Obsolete 


Service Name 


Add_Member 


Remove_Member | Obsolete 


4Chex 


Behavior 


The behavior of the Assembly Object differs by the type of Assembly: dynamic or static. A 
Dynamic Assembly’s member list is created and managed by the user of the device. The 
manager of the dynamic assembly must specify and maintain the member list. 


A Static Assembly’s member list is defined by the device manufacturer. It cannot be modified. 


To provide for the ability to create and delete objects, as well as change member lists, Dynamic 
Assemblies support additional services which are not supported by Static Assemblies. 


The following rules apply to the member lists of both static and dynamic assemblies. 


When an empty path (Member Path Size = 0) is used in an assembly member list, the assembly 
inserts/discards the number of bits as specified in the Member Data Size field when 
producing/consuming. The assembly shall use a value of zero for all produced data which has 
been inserted. The use of an empty consumed path allows, for example, data destined for 
multiple nodes to be sent in a single message since each node can be configured to discard data 
in the message not intended for it. 


The empty path shall be supported for all dynamic assemblies. 


No checking is done by the Assembly Object at any time to verify that the size of the member 
data is correct for the given member path. It is the responsibility of the assembly member to 
properly handle too much or too little data. The assembly is required to deliver the configured 
number of bits to the member. 


No padding is done by the Assembly Object to align data from each assembly member on a 
byte, word, or other boundary. 
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5-5.5.1 Static Assemblies 


The following State Transition Diagram, State Event Matrix and Attribute Access Table 
illustrate the behavior of Static assemblies. 


Figure 5-5.7 Static Assembly State Transition Diagram 


Non-Existent 


Get_Attribute_Single/ 
Set_Attribute_Single 
Set on attribute 3 (only) 


! 
! 
1 
I 
I 
1 
I 
! 
I 
I 
Message Produced/Consumed/ 
1 
1 
I 
End of}Production/ Consumption 
I 
! 
! 
1 
I 
1 
1 
1 
! 
1 
I 


Get next Member, 
Produce/Consume 
to/from Member 


Table 5-5.8 Static Assembly State Event Matrix 


Static Assembly Object State 


Power Up Not applicable Not applicable 


Get_Attribute | Error: Object does not exist. | Validate/service the request | Validate/service the request 
_Single (General Error Code 16;,,) | Return response Return response 

Set_Attribute | Error: Object does not exist. | Validate/service the request | Error: Object State Conflict 
_Single (General Error Code 16p¢x) Return response (General Error Code 0Chex) 


Message Error: Object does not exist. | Begin producing/consuming | Error: Object State Conflict 
produced/ (General Error Code 16,,,) from/to each member in list | (General Error Code 0C,.x) 
consumed Transition to Active 

End of Error: Object does not exist. | Error: Object State Conflict | Transition to Inactive 
production/ (General Error Code 16nex) (General Error Code 0Chex) 

consumption 


Table 5-5.9 Static Assembly Object Attribute Access 


Static Assembly Object State 


Attribute ae 
Number_of_Members Read Only 
Member_List Not available Read Only 
Data Not available Read Only 
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5-5.5.2 Dynamic Assemblies 


The State Transition Diagram, State Event Matrix and Attribute Access Table below illustrate 
the behavior of Dynamic assemblies. 


Figure 5-5.10 Dynamic Assembly State Transition Diagram 
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Table 5-5.11 Dynamic Assembly State Event Matrix 


Dynamic Assembly Object State 


Create Class instantiates an Assembly | Not applicable Not applicable 
Object. Transition to Inactive 


Delete Error: Object does not exist. Release all associated Error: Object State 
(General Error Code 0x16) resources. Transition to Conflict (General Error 
Non-Existent Code 0x0C) 
Get_Attribute_Single | Error: Object does not exist. Validate/service the request. | Validate/service the 
(General Error Code 0x16) Return response request. Return response 
Set_Attribute_Single | Error: Object does not exist. Validate/service the request. | Error: Object State 


(General Error Code 0x16) Return response Conflict (General Error 
Code 0x0C) 


Insert_Member Error: Object does not exist. Validate/service the request. | Error: Object State 
(General Error Code 0x16) Return response Conflict (General Error 
Code 0x0C) 


Remove_Member Error: Object does not exist. Validate/service the request. | Error: Object State 
(General Error Code 0x16) Return response Conflict (General Error 


Code 0x0C) 

Message produced/ Error: Object does not exist. Begin producing/consuming | Error: Object State 
consumed (General Error Code 0x16) from/to each member in list. | Conflict (General Error 

Transition to Active. Code 0x0C) 
End of production/ Error: Object does not exist. Error: Object State Conflict | Transition to Inactive 
consumption (General Error Code 0x16) (General Error Code 0x0C) 
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Table 5-5.12 Dynamic Assembly Object Attribute Access 


Dynamic Assembly Object State 


Ausbite fue 
Number_of_Members Read Only 
Member_List! Not available Read Only 
Data Not available Read Only 


1 This attribute can be set by either the Insert_Member service (one member at a time) 
or the Set_Attribute_Single service (all members at once). 


5-5.5.3 Connection Points 


Connection Points within the Assembly Object are identical to Instances. For example, 
Connection Point 4 of the Assembly Object is the same as Instance 4. Specifying an EPATH 
of “20 04 24 VV 30 03” is the same as “20 04 2C VV 30 03”. 
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5-6 Connection Object 
Class Code: 05 hex 


Use the Connection Object to manage the characteristics of a communication connection. 


See Chapter 3 for the definition of this object class. 
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5-7 Connection Manager Object 
Class Code: 06 hex 


Use this object for connection and connectionless communications, including establishing 
connections across multiple subnets. 


See Chapter 3 for the definition of this object class. 
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5-8.1 


5-8.2 


5-8.3 


Register Object, Class Code: 07 pex 


Register Object 
Class Code: 07 hex 


Use this object to address individual bits or a range of bits up to 64K bits of data. 


Note that a Register object can operate as either an input register or an output register. The 
terms “input” and “output” are defined from the network’s point of view. An input will 
produce data on the network and an output will consume data from the network. 


Class Attributes 


Table 5-8.1 Register Object Class Attributes 


Attribute Need in Access Rule | Name Data Description of | Semantics of 
ID Implementation Type Attribute Values 


1thru 7 | These class attributes are optional and are described in Chapter 4 of this specification. 


Instance Attributes 


Table 5-8.2 Register Object Class Attributes 


Attribute Need in Access Rule Name Data Description of Semantics of 
ID eee Type Attribute Values 
Required Direction |BOOL Direction of 0=Input Register, 
data transfer 1=Output 
Register 
Required Size UINT Size of register 
data in bits 
Required Set (Set is 
optional if 
Direction=1) 


Common Services 


The Register Object provides the following Common Services: 


Table 5-8.3 Register Object Common Services 


Need in 


Service Implementation 
Code Service Name Description of Service 


Returns the contents of the 
specified attribute. 


pe ee 


n/a Set_Attribute_Single 


*The Get_Attribute_Single service is REQUIRED if any attributes are implemented. 


Modifies an attribute value. 


See Appendix A for definition of these services 
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5-8.4 Object—specific Services 


The Register Object provides no Object—specific services. 


5-8.5 Behavior 


The State Transition Diagram, State Event Matrix, and Attribute Access Table below illustrate 
the behavior of the Register Object. 


Figure 5-8.4 Register Object State Transition Diagram 


Non-Existent 


Power Up 


Get_Attribute_Single/ 


Message 
Set_Attribute_Single 


Produced/Consumed 


Table 5-8.5 Register Object State Event Matrix 


Event State 


Power up Transition to Run Not applicable. 


Get_Attribute_Single Error: Object does not exist Validate/service the request. 
(General Error Code 16h. ) Return response. 

Set_Attribute_Single Error: Object does not exist Validate/service the request. 
(General Error Code 16pex) Return response. 


Message Error: Object does not exist Apply/retrieve data. 
produced/consumed (General Error Code 16h.x) 
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Discrete Input Point Object 
Class Code: 08 hex 


The Discrete Input Point (DIP) Object models discrete inputs in a product. You can use this 
object in applications as simple as a toggle switch or as complex as a discrete I/O control 
module. Note that the term ”input” is defined from the network’s point of view. An input will 
produce data on the network. 


The Discrete Input Point interface is to real input points such as a switch or screw terminal. 
The input is sampled and the data is stored in this object’s VALUE attribute. A sample of the 
discrete input value is triggered via an external command (input change-of-state, cyclic data 
trigger, etc.) 


Revision History 


Since the initial release of this object class definition changes have been made that require a 
revision update of this object class. The table below represents the revision history: 


Table 5-9.1 Discrete Input Point Object Revision History 


Revision Reason for object definition update 
01 Initial Definition at First Release of Specification 
02 IDLE state removed from this object’s behavior 
Class Attributes 


Table 5-9.2 Discrete Input Point Class Attributes 


Attribute Need in Access Name Data Type | Description of | Semantics of 
ID Implementation | Rule Attribute Values 


1 Required Get Revision UINT Revision of this | The current 
object value assigned 
to this attribute 

is two (02). 


2 thru 7 | These class attributes are optional and are described in Chapter 4 of this specification. 
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5-9.3 Instance Attributes 


Table 5-9.3 Discrete Input Point Object Instance Attributes 


Attribute | Needin | Access | NV Name Data Description of Attribute | Semantics of Values 
ID Implem. | Rule Type 


1 Optional | Get Number of |USINT | Number supported in this 
Attributes product 


2 Optional | Get Attribute ARRAY | List of attributes supported 
List in this product 
freee al, dere cs ich ee cay ies one 
1=on 


4 Optional | Get Status BOOL Input point status 0=OK; 1=product 
specific alarm or 
status 

5 Optional | Set Off_On UINT filter time for off to on The default value is 

Delay transition 0. 
0 - 65,535 microseconds ! 
6 Optional | Set On_Off UINT filter time for on to off The default value is 
Delay transition 0. 
0 - 65,535 microseconds * 
7. Optional Set? NV |Off_On UDINT _|Total number of times the |[default] = 0 
Cycles Value attribute transitioned 
from the Off to the On 
state 


1 The input must be on for the amount of filter time specified by the OFF_ON DELAY attribute before the ON 
state is recorded in the VALUE attribute. 


2 The input must be off for the amount of filter time specified by the ON_OFF DELAY attribute before the OFF 
state is recorded in the VALUE attribute. 


3 Applications including this attribute may restrict its access to Get Only; thus, allowing the application support of 
a factory initialized cycle life indication. 


5-9.4 Common Services 


The Discrete Input Point Object provides the following Common Services: 


Table 5-9.4 Discrete Input Point Object Common Services 


Need in 
Service Implementation 


Code Service Name Description of Service 
OEhex Get_Attribute_Single Returns the contents of the specified attribute. 


Olhex |Optional | Optional | Get_Attributes_All Returns a predefined listing of this objects 
attributes (See the Get_Attributes_All Response 
definition below) 


10hex Set_Attribute_Single Modifies an attribute value. 


O02hex |Optional | Optional | Set_Attributes_All Modifies the value of a list of attributes (See the 
Set_Attributes_All Request definition below) 


See Appendix A for definitions of these common services. 


— 5-55 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 2 


5-9.4.1 
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Get_Attributes_All Response 


” 


At the Class level, the order of the attributes returned in the “Object/service specific reply data 
portion of the Get_Attributes_All response is as follows: (see Chapter 4 for a description of the 
Get_Attributes_All Service Data field) 


Table 5-9.5 Get_Attributes All Response Data — Class Level 


Byte Bit 7 Bit 6 Bit5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
0 Revision (low byte) 
1 Revision (high byte) Default = 0 
2 Max Instance (low byte) Default = 0 
3 Max Instance (high byte) Default = 0 
4 Max ID Number of Class Attributes (low byte) Default = 1 
5 Max ID Number of Class Attributes (high byte) Default = 0 
6 Max ID Number of Instance Attributes (low byte) Default = 3 
7 Max ID Number of Instance Attributes (high byte) Default = 0 


Important: Insert default values for all unsupported attributes. 


At the Instance level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows: 


Table 5-9.6 Get_Attributes_All Response Data — Instance Level 


Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
Number of Attributes Default = 0 


Attribute List (attribute #1) 


Attribute List (attribute #m) 


Status 
Default = 
0 


Off_On Delay (low byte) Default = 0 
Off_On Delay (high byte) Default = 0 


On_Off Delay (low byte) Default = 0 
On_Off Delay (high byte) Default = 0 


Important: Insert default values for all unsupported attributes. 


Important: If the instance attribute ” Number of Attributes” is not supported, the default value 
of zero is to be inserted in its place and no members of the ”Attribute List” attribute will 
follow. 
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5-9.4.2 Set_Attributes_All Request 


No settable attributes currently exist at the Class level for the Discrete Input Point Object. 


At the Instance level, the order of attributes passed in the Set_Attributes_All request is as 
follows: 


Table 5-9.7 Set_Attributes_All Request Service Data — Instance Level 


Bit 7 Bit 6 Bit5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
Off_On Delay (low byte) 
Off_On Delay (high byte) 
On_Off Delay (low byte) 
On_Off Delay (high byte) 


Important: The Set_Attributes_All service is to be supported only if all settable attributes 
shown above are implemented as settable. 


5-9.5 Object—specific Services 


The DIP Object provides no Object—specific services. 


5-9.6 Behavior 


The State Transition Diagram in Figure 5-9.6.1 provides a graphical description of the events 
and corresponding state transitions. A subset of the states and events may be supported in an 
application, but the behavior must be consistent. 


The State Event Matrix in Table 5-9.6.1. lists all pertinent events and the corresponding action 
to be taken while in each state. 


Important: Events can occur simultaneously, but the Fault events have priority if they occur 
simultaneously with other events. 


The following behavior is related to the Off_On Cycles attribute. The value of Off_On Cycles 
is incremented once for each time the input transitions from an ‘Off’ state to a ‘On’ state. The 
purpose is to assist in tracking the cycles the device that is reporting the input has encountered. 
Upon reaching a terminal count (maximum value) and experiencing another cycle to count, the 
Off_On Cycles value will "wrap" to a value of zero (0) and continue to count cycles as 
described. 
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Figure 5-9.8 State Transition Diagram for Discrete Input Point Object 
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Important: Events can occur simultaneously, but the Fault events have priority if they occur 
simultaneously with other events. 


The following SEM contains these states: 


e Non-Existent: a module without power. 

e Available: waiting for a connection, power-up discrete input point defaults are set. 
e Run: DIP sensing data from its input and transmitting the data. 

e Recoverable Fault: a recoverable fault has occurred. 

e Unrecoverable Fault: an unrecoverable fault has occurred. 


The SEM also contains these events: 


Table 5-9.9 Discrete Input Point Object Event Definitions 


This event Is 
Sample Trigger a change of state, cyclic timer trigger, application trigger 
Connection Deleted I/O connection deleted. 
Apply_Attributes the Apply service of the I/O connection object the Discrete Input Point object is 


connected to. Note: the application is responsible for validating the connection 
object’s attributes. 


Fault Cleared the application clearing a detected fault 


Connection Transitions I/O connection transitions to Established. 
to Established 


Connection Transitions I/O connection transitions to Timed-Out 
to Timed Out state 
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The figure below is a conceptual illustration of the state machine for a typical input object 
(producing application). The events listed above are represented by the dotted line labeled 
“state change.” 


Figure 5-9.10 State Machine Illustration for Typical Discrete Input Point Object 
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Table 5-9.11 State Event Matrix for the Discrete Input Point Object 


State 


Event Non-Existent Available Recoverable | Unrecoverable 

Fault Fault 
Sample Trigger Not Applicable Ignore event Sample data, Ignore event Ignore event 
Send data 


Return error Ignore event 
(Object State 


Return error 
attributes, return | (Object State 
Conflict) Conflict) 


Connection Deleted Not Applicable Ignore Event Transition to Transition to Ignore event 
Available Available 

Connection Transitions | Not Applicable Transition to Ignore event Ignore event Ignore event 

to Established Run 


Connection Transitions | Not Applicable Ignore event Transition to Ignore event 
to Timed Out state Recoverable 
Fault 
Fault Cleared Not Applicable Not Applicable | Not Applicable Transition to Ignore event 
Run 
Get_Attribute Return Error Return value Return value Return value Ignore event 
(Object Does Not Exist) 
Set_Attribute Return Error Accept value Accept value Accept value | Ignore event 
(Object Does Not Exist) 


I/O Status LED Off Off Solid Green Flash Red Solid Red 


Apply Attributes Not Applicable 
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5-9.6.1 Attribute Access Rules 


Except in the Non-Existent and Unrecoverable Fault states, all attributes are gettable or settable 
according to their access rules. 


Because the only required Instance attribute is Value, the only required behavior of a Discrete 
Input Point is that it indicates a boolean value of OFF or ON. The optional attributes either 
provide more information about the discrete input point or alter the behavior of the input point. 


Figure 5-9.12 Discrete Input Point Object Value Attribute Illustration 


point transitions 
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OFF : i ON 
point transitions 
to OFF 


5-9.6.1.1 Status Instance Attribute 


The optional Status Instance attribute is simply a logical OR of all possible failure or alarm 
conditions for the point. 


Figure 5-9.13 Discrete Input Point Object Status Attribute Function 
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Discrete Output Point Object 
Class Code: 09 hex 


A Discrete Output Point (DOP) models discrete outputs in a product. You can use this object 
in applications such as discrete I/O control modules, relays, switches, etc. Note that the term 
“output” is defined from the network’s point of view. An output will consume data from the 

network. 


The Discrete Output Point interface is to real output points such as a relay or LED. The output 
is read from this object’s VALUE attribute and applied to the output terminal (e.g. screw 
terminal). 


Class Attributes 


Table 5-10.1 Discrete Output Point Object Class Attributes 


Attribute Need in Access Name Data Description of | Semantics of Values 
ID Implementation Rule Type Attribute 


1 thru 7 


These class attributes are optional and are described in Chapter 4 of this specification. 


Instance Attributes 


Table 5-10.2 Discrete Output Point Object Instance Attributes 


Attribute Need in Access Name Data Description of | Semantics of Values 
ID Implementation Rule Type Attribute 


1 Optional Get Number of 
Attributes 


USINT 


Number of 
attributes 


supported in this 
product 


2 Optional Get Attribute List | ARRAY | List of attributes 
OF supported in this 
USINT product 


BOOL Output point value | 0=off; 
1=on 
Status BOOL Output point status | O=OK; 1=failure or 
alarm 


Fault Action |BOOL Action taken on 0=Fault Value 
output’s value in | attribute; 
6 Optional Set Fault Value BOOL 


Recoverable Fault | 1=hold last state 
7 Optional Set Idle Action BOOL 


state 

8 Optional Set Idle Value BOOL User-defined value | 0=off; 
for use with Idle 1=on 
State attribute 


Value 


3 Required 


Optional 


Set 
Get 
Set 


5 Optional 


User—defined value | 0=off; 
for use with Fault | 1=on 
State attribute 


Action taken on 0=Idle Value 
output’s value in | attribute; 1=hold last 
Recoverable Fault | state 

state 


os 
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Attribute Need in Access Name Data Description of | Semantics of Values 
ID Implementation Rule Attribute 


Type 
9 Optional BOOL Generates the 0=Receive_Idle 
Receive_Idle or 1=Receive_Ready_to 
Receive_ —_ Run 
Ready_to_ Run 
event 
10 Optional BOOL Flash output at O=no flash; 
periodic rate if 1=flash 
point is ON 
11 Optional Flash Rate USINT Flash Rate for unsigned positive 
Flash attribute integer indicating 
frequency in Hz, e.g. 
1= 1Hz 


12 Optional Get Object State | USINT State of the object | 1 = Non-Existent 
2 = Available 
3 =Idle 
4 = Ready 
5 = Run 
6 = Recoverable 
Fault 
7 = Unrecoverable 
Fault 
255 = Reserved 


: ag 


Mode for 
1 — This attribute is not allowed if the device is not a safety device. If the device is a safety device, see Volume 5. 


See CIP Safety Specification (Volume 5, Chapter 5) 
Safety 


Important: Optional attributes either provide more information about the discrete output point 
or alter the behavior of the output point. If the following optional instance attributes are not 
supported the default attribute values below indicate the required behavior for instances of this 
object class: 


Table 5-10.3 Optional Attribute Default Values 


Attribute Name Default 
ID Value 
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5-10.2.1 Value 


The only required Instance attribute is Value. The required behavior of a Discrete Output 
Point’s value is that it outputs a boolean value of OFF or ON. 


Figure 5-10.4 Discrete Output Point Object Value Attribute Illustration 
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5-10.2.2 Status 
The Status attribute is simply a logical OR of all possible failure or alarm conditions for the 


point. 


Figure 5-10.5 Discrete Output Point Status Attribute 
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5-10.2.3 Fault and Idle Attributes 


These optional attributes define a safe state for the DOP when in the Idle or Recoverable Fault 
states: 


e Fault Action 
e Fault Value 
e Idle Action 
e Idle Value 


Table 5-10.6 Fault/Idle Action Pair Definition 


This attribute pair Defines 


Fault Action and Fault Value the value of the DOP in the Fault state. 


Idle Action and Idle Value the value of the DOP in the Idle state. 


The following dependencies exist among these attributes: 


Table 5-10.7 Fault/Idle Action Pair Dependencies 


If this attribute 


- Then this attribute must also be supported by definition 
is supported 


Fault Action Fault Value (although this attribute could be defined to always be OFF). 


Idle Action Idle Value (although this attribute could be defined to always be OFF). 


The “Action” attributes dictate what the DOP will do upon entering that state. The DOP will 
either hold its value in the last state or update it to the value stored in the corresponding Fault 
or Idle Value attribute. 
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5-10.2.5 


5-10.2.6 


5-10.3 


Discrete Output Point Object, Class Code: 09x 


Upon entering the Recoverable_Fault state the DOP will behave according to the following 
table. 


Table 5-10.8 Recoverable Fault State Behavior 


Fault_State = 0 Fault_State = 1 
Fault_Value = 0 DOP uses the value in the Fault_Value DOP leaves Value in last state. 
attribute (0) to update its value. Fault_Value attribute has no affect. 
Fault_Value = 1 DOP uses the value in the Fault_Value DOP leaves Value in last state. 
attribute (1) to update its value. Fault_Value attribute has no affect. 


The Idle attributes follow similar behavior. 


Important: There is one deviation from the behavior specified in the table above. If the DOP 
enters the Recoverable_Fault state from the Idle state in response to the I/O connection 
transitioning to Timed Out, the DOP’s value should go unchanged. This is shown in the 
DOP’s State Transition Diagram. 


Run_Idle Command 


The Run_Idle Command attribute causes the Receive_Ready_to_Run or Receive_Idle event to 
be sent to the DOP. Refer to the DOP’s State Transition Diagram to see the resulting 
transitions. This attribute only has effect when the Discrete Output object is in the Idle, Ready, 
or Run states. While in the Available or Recoverable Fault state, an attempt to set this attribute 
will result in an Object_State_Conflict error. A read (Get_Attribute_Single) of this attribute 
will result in a zero being returned always. 


Flash 


The Flash attribute modifies the behavior of the DOP such that when the DOP is in the ON 
state, the output flashes OFF and ON at a periodic rate. 


Flash Rate 


The Flash Rate attribute modifies the behavior of the DOP in that when the DOP is in the ON 
state and the Flash attribute is ON, it sets the periodic flash rate by an unsigned positive 
integer. 


Common Services 
The Discrete Output Object provides the following Common Services: 


Table 5-10.9 Discrete Output Point Object Common Services 


Service | Need in Implementation 


Conditional* Get_Attribute_Single 


Optional Get_Attributes_ All 


Description of Service 


Returns the contents of the 
specified attribute. 


Modifies an attribute value. 


O1hex Returns a predefined listing of this 
objects attributes (See the 
Get_Attributes_All Response 


definition below) 
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Service | Need in Implementation 


: mae ie 


*The Get_Attribute_Single service is REQUIRED if any attributes are implemented. 


Description of Service 


Modifies the contents of the 
attributes of the class or object. 


O2hex 


See the Appendix A for definitions of these common services. 


5-10.3.1 Get_Attributes_All Response 


At the Class level, the order of the attributes returmed in the “Object/service specific reply data” 
portion (see Chapter 4 of Volume I for a description of the Service Data field) of the 
Get_Attributes_All response is as follows: 


Table 5-10.10 Get_Attributes_All Response Data — Class Level 


Byte Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
0 Revision (low byte) Default = 1 
Revision (high byte) Default = 0 
Max Instance (low byte) Default = 0 
Max Instance (high byte) Default = 0 
Max ID Number of Class Attributes (low byte) Default = 0 
Max ID Number of Class Attributes (high byte) Default = 0 
Max ID Number of Instance Attributes (low byte) Default = 3 


NYO] oy; RR] Ww] NMR 


Max ID Number of Instance Attributes (high byte) Default = 0 


Important: Insert default values for all unsupported attributes. 


At the Instance level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows: 


Table 5-10.11 Get_Attributes_All Response Data — Instance Level 


Status Default = 0 


Fault State Default = 0 
Fault Value Default = 0 
Idle State Default = 0 
Idle Value Default = 0 
Flash Default = 0 


Flash Rate Default = 0 
Object State Default = 255 


Important: If the instance attribute ” Number of Attributes” is not supported, the default value 
of zero is to be inserted in its place and no members of the ”Attribute List” attribute will 
follow. 
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Important: Insert default values for all unsupported attributes. 


5-10.3.2. Set_Attributes_All Request 


No settable attributes currently exist at the Class level for the Discrete Output Point object. 


At the Instance level, the order of attributes passed in the Set_Attributes_All request is as 
follows: 


Table 5-10.12 Set_Attributes_All Request Data — Instance Level 


Flash Rate 


Important: The Set_Attributes_All service is to be supported only if all settable attributes 
shown above are implemented as settable. 
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Object—specific Services 


The Discrete Output Point Object provides no Object—specific services. 


Behavior 


The State Transition Diagram in Figure 5-10.5.1 provides a graphical description of the events 
and corresponding state transitions. A subset of the states and events may be supported in an 
application, but the behavior must be consistent. 


The State Event Matrix in this section lists all pertinent events and the corresponding action to 
be taken while in each state. 


Important: Events can occur simultaneously, but the Fault events have priority if they occur 
simultaneously with other events. In addition, if the Receive_Data event occurs simultaneously 
with any other event, the other event takes precedence. 
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Figure 5-10.13 State Transition Diagram for Discrete Output Point Object 
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* And no other faults exist Note: LED = I/O Object Status LED 


The SEM contains the following states: 


e Non-Existent: module without power. 

e Available: DOP defaults configured, waiting for connection. 
e Idle: DOP in Idle mode and does not apply received data. 

e Ready: waiting for valid data to apply. 

e Run: DOP applying received data to its output. 

e Recoverable Fault: a recoverable fault has occurred. 

e Unrecoverable Fault: an unrecoverable fault has occurred. 
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The SEM also contains these events: 


Table 5-10.14 Discrete Output Point Event Definitions 


This event Is 


Receive_Data an event that signals the reception of I/O data and causes 
the object to transition to the Run state. 


Receive_Fault an event that is internally generated and product-specific. 
The network does not know if a Fault has occurred. 


Receive_Idle the setting of the Run_Idle Command attribute to the 
value 0 -or- the IO connection object receives an I/O 
message containing no application data 


Receive Run the setting of the Run_Idle Command attribute to the 
value 1. 
Apply_Attributes the Apply service of the I/O connection object the 


Discrete Output Point object is connected to. Note: the 
application is responsible for validating the connection 
object’s attributes. 


Connection Deleted I/O connection deleted. 
Connection Transitions to I/O connection transitions to Established. 
Established 


Connection transitions to the Timed _| the expiration of the connection timer. 
Out state 
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Table 5-10.15 State Event Matrix for the Discrete Output Point Object 


State 
Event Non - Available Ready Recoverable | Unrecoverable 
Existent Fault Fault 


Receive_Data Not applicable If data length is LED Solid If data length is } Ignore event Ignore event 
sola non-zero Green, Accept zero” 
transition to Run | Data, Transition] Transition to 
Verify and to Run Idle 
Accept Data Otherwise 
Transition to Run Verify and 
Ignore event Accept Data 


Receive_Fault Not applicable Not Transition to Transition to Transition to Ignore event Ignore event 
applicable Recoverable Recoverable Recoverable 
Fault * Fault * Fault‘ 


Receive_Idle Not applicable | Return Error Ignore event Transition to Transition to Return Error Ignore event 
(object state Idle? Idle? (object state 
conflict) conflict) 


Receive_Ready_ Not applicable } Return Error Transition to Ignore event Ignore event Return Error Ignore event 
to_Run (object state Ready (object state 
conflict) conflict) 
Validate_Connection | Not applicable Verify Return Error Return Error Return Error Return Error Ignore event 
_ Attributes attributes, (object state (object state (object state (object state 
return results conflict) conflict) conflict) conflict) 

Available Available Available Available 
Connection Not applicable | Transition to Return Error Return Error Return Error Transition to Ignore event 
Transition to Ready (object state (object state (object state Ready 3 
Established conflict) conflict) conflict) 
Connection Not applicable Not Transition to Transition to Transition to Ignore event Ignore event 
transitions to applicable Recoverable Recoverable Recoverable 


Timed Out state Fault Fault Fault! 


Get_Attribute Return Error | Return value Return value Return value Return value Return value Ignore event 
(Object Does 
Not Exist) 


Set_Attribute Return Error | Verify, and Verify, and Verify, and Verify, and Verify, and Ignore event 


(Object Does | Accept, and Accept, and Accept, and Accept, and Accept, and 
Not Exist) Apply value Apply value Apply value Apply value Apply value 


Fault_Cleared Ignore event | Ignore event Ignore event Ignore event Ignore event Transition to Ignore event 
3 
Ready 


1 Fault: Hold Last State OR use Fault Value. 
2 Idle: Hold Last State OR use Idle Value. 
3 Ifno other faults exist (Note, a Connection time out is considered a fault) 


5-10.5.1 Attribute Access 


Except in the Non-Existent and Unrecoverable Fault states, all attributes are gettable or settable 
according to their access rules. 
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5-11.1 


5-11.2 


Analog Input Point Object, Class Code: 0Apex 


Analog Input Point Object 


Class Code: 0A hex 


The Analog Input Point (AIP) Object models analog inputs in a product. It can be used in 
applications as simple as a single analog point and as complex as an analog I/O control module. 
Note that the term ”input” is defined from the network’s point of view. An input will produce 
data on the network. 


The Analog Input Point interface is to real input points such as a thermocouple or pressure 
transducer. The input is sampled and the data is stored in this object’s VALUE attribute. A 
sample of the analog input value is triggered via an external command (input change-of-state, 
cyclic data trigger, etc.) 


Revision History 


Since the initial release of this object class definition changes have been made that require a 
revision update of this object class. The table below represents the revision history: 


Table 5-11.1 Analog Input Point Object Revision History 


Revision Reason for object definition update 
01 Initial Definition at First Release of Specification 
02 IDLE state removed from this object’s behavior 
Class Attributes 


Table 5-11.2 Analog Input Point Object Class Attributes 


Attr ID Need in Access Name Data Description of Semantics of Values 
Implementation | Rule Type Attribute 
1 Required Get Revision UINT Revision of this | The current value assigned 
object to this attribute is two (02). 


2 thru 7 | These class attributes are optional and are described in Chapter 4 of this specification. 
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5-11.3 Instance Attributes 


Table 5-11.3 Analog Input Point Object Instance Attributes 


Attr ID Need in Access Name Data 
Implementation | Rule Type 


Get Number of 


Attributes 


1 Optional 


USINT Number of 
attributes 
supported 

Array of | List of attributes 

USINT supported by the 
point 


Value INT or Analog input 
based on 
attribute 8 


Get 


Attributes 
List 


2 Optional 


3 Required 
value. The data 
type defaults to 
INT but may be 


Get 
attribute 8. 
et 


iN 


an 


Optional G 


5 Optional 


Get 
Optional Get 


Owner Serial | UDINT 32-bit serial 
Number number of 
channel’s owner 


Set Input Range | USINT Input range the 
point is operating 
in 

Set Value Data | USINT Determines the 
data type of 
Value 


7 Optional 


8 Optional 


changed based on 


, Part 2 


Description of Semantics of Values 
Attribute 


alarms or faults. 


1=alarm or fault condition 
exists, the Value attribute 
may not represent the actual 
field value. 


Status BOOL Indicates if a fault | O= operating without 
or alarm has 
occurred. 


Owner UINT Vendor ID of 
Vendor ID channel’s owner 


0 =-10V to 10V 
1=0V to 5V 

2 =0V to 10V 

3 = 4mA to 20mA 
4=-15mV to 75mV 

5 =-15mV to 30mV 

6 =-5V to 5V 
7=1Vto5V 

8 = OmA to 20mA 

9 = 0mA to 50mA 

10 — 99 = Reserved 
100-131=Vendor Specific 
132-154 =Reserved 
255 = Only return with 
Get_Attributes_All if 
attribute not supported 
0=INT 

1= REAL 

2 = USINT 

3 = SINT 

4=DINT 

5 = LINT 

6 = UINT 

7 = UDINT 

8 = ULINT 

9 = LREAL 

100 = vendor specific 


Type 
— 5-72 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 2 


Analog Input Point Object, Class Code: 0Apex 
5-11.4 Common Services 


The Analog Input Object provides the following Common Services: 


Table 5-11.4 Analog Input Point Object Common Services 


Service Need in Implementation 
Code Service Name Description of Service 


OEhex |Required | Required Get_Attribute_Single | Returns the contents of the 
specified attribute. 


10hex Set_Attribute_Single | Modifies an attribute value. 


Olhex | Optional Optional Get_Attributes_All Returns a predefined listing of this 
objects attributes (See the 
Get_Attributes_All Response 
definition below) 


O02hex n/a Optional Set_Attributes_All Modifies the contents of the 
attributes of the class or object. 


1 The Set_Attribute_Single service is required only if Instance Attributes 7 and/or 8 are 
implemented. 


See Appendix A for definition of these services 


5-11.4.1 Get_Attributes_All Response 


At the Class level, the order of the attributes returned in the “Object/service specific reply data” 
portion of the Get_Attributes_All response is as follows: 


Table 5-11.5 Get_Attributes_All Response Data — Class Level 
0 Revision (low byte) Default = 2 
Revision (high byte) Default = 0 
Max Instance (low byte) Default = 0 
Max Instance (high byte) Default = 0 
Max ID Number of Class Attributes (low byte) Default = 0 
Max ID Number of Class Attributes (high byte) Default = 0 
Max ID Number of Instance Attributes (low byte) Default = 3 


NTO] Us) RR] Ww] Nir 


Max ID Number of Instance Attributes (high byte) Default = 0 


Important: Insert default values for all unsupported attributes. 
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At the Instance level, the order of the attributes returned in the “Object/service specific reply 
data” portion (see Chapter 4 for a description of the Service Data field) of the 
Get_Attributes_All response is as follows: 


Table 5-11.6 Get_Attributes_All Response Data — Instance Level 


Cae [aes [ae ae | 


Number of Attributes Default = 0 


Attribute List (attribute #1) 


Attribute List (attribute #m) 
Value Data Type Default = 0 


Value (low byte) 


Value (high byte) 


Status 
eee = 


Owner Vendor ID (low byte) Default = 
Owner Vendor ID (high byte) Default = 
Owner Serial Number (low byte) Default = 0 
Owner Serial Number Default = 0 
Owner Serial Number Default = 0 
Owner Serial Number (high byte) Default = 0 
Input Range Default = 255 * 


The default value of 255 must be returned for the Input Range attribute ONLY if it is not 
supported by the device. 


Important: Insert default values for all unsupported attributes. 
Important: If the instance attribute * Number of Attributes” is not supported, the default value 


of zero is to be inserted in its place and no members of the ”Attribute List” attribute will 
follow. 


5-11.4.2. Set_Attributes_All Request 


No settable attributes currently exist at the Class level for the Analog Input Point object. 


At the Instance level, the order of attributes passed in the Set_Attributes_AlI request is as 
follows: 


Table 5-11.7 Set_Attributes_All Request Data — Instance Level 


Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
Input Range 
Value Data Type 


Important: The Set_Attributes_All service is to be supported only if all settable attributes 
shown above are implemented as settable. 
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Object—specific Services 


The Analog Input Object provides no Object-specific services: 


Behavior 


The State Transition Diagram in Figure 5-11.8 provides a graphical description of the events 
and corresponding state transitions. A subset of the states and events may be supported in an 
application, but the behavior must be consistent. 


The State Event Matrix in this section lists all pertinent events and the corresponding action to 
be taken while in each state. A subset of the states and events may be supported in an 
application, but the behavior must still be consistent. 


Figure 5-11.8 State Transition Diagram for Analog Input Point Object 
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Power Up 
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Fault Cleared 


LED Solid Green 
() Recoverable 
Fault 
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1. Indicated by the application LED = I/O Status LED 


Important: Events can occur simultaneously, but the Fault events have priority if they occur 
simultaneously with other events. 


The SEM contains the following states: 


e Non-Existent: module with no power. 

e Available: waiting for a connection, power-up analog input point defaults are set. 
e Run: AIP sensing data from its input and transmitting the data. 

e Recoverable Fault: a recoverable fault has occurred. 

e Unrecoverable Fault: an unrecoverable fault has occurred. 
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The SEM also contains these events: 


Table 5-11.9 Analog Input Point Object Event Definitions 


This event Is 

Sample Trigger a change of state; cyclic timer trigger; non-zero length Bit Strobe or Poll Command. 

Connection Deleted 1/O connection deleted. 

Apply_Attributes the Apply service of the I/O connection object the Analog Input Point object is 
connected to. Note: the application is responsible for validating the connection object’s 
attributes. 

Fault Cleared the application clearing a detected fault 


Connection Transitions I/O connection transitions to Established. 
to Established 


Connection Transitions I/O connection transitions to Timed-Out 
to Timed Out state 


Figure 5-11.10 shows a conceptual illustration of the state machine for a typical input object 
(producing application). The events listed above are represented by the dotted line labeled 
“state change.” 


Figure 5-11.10 State Machine Illustration for Typical Analog Input Point Object 
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5-11.6.1.1 


Analog Input Point Object, Class Code: 0Apex 
Table 5-11.11 State Event Matrix for the Analog Input Point Object 


State 


Event Non-Existent Available Recoverable | Unrecoverable 
Fault Fault 
Sample Trigger Not Applicable | Ignore event Sample data, Ignore event | Ignore event 
Send data 


Apply Attributes Not Applicable | Verify attributes, | Return error Return error | Ignore event 
return result (Object State (Object State 
Conflict) Conflict) 


Connection Deleted Not Applicable | Ignore Event Transition to Transition to | Ignore event 
Available Available 

Connection Transitions | Not Applicable | Transition to Ignore event Ignore event | Ignore event 
to Established Run 

Connection Transitions | Not Applicable | Ignore event Transition to Ignore event | Ignore event 
to Timed Out state Recoverable Fault 

Fault Cleared Not Applicable | Not Applicable | Not Applicable Ignore event 

Run 


Get_Attribute Return Error Return value Return value Return value | Ignore event 
(Object Does 
Not Exist) 

Set_Attribute Return Error Accept value Accept value Accept value | Ignore event 
(Object Does 
Not Exist) 


I/O Status LED Flash Green Solid Green Flash Red Solid Red 


Attribute Access Rules 


Except in the Non-Existent and Unrecoverable Fault states, all attributes are gettable or settable 
according to their access rules. 


Because the only required Instance attribute is Value, the only required behavior of an AIP is 
that it indicates an analog value. 


Optional attributes either provide more information about the AIP or alter the behavior of the 
input point. 


Status Attribute 


The optional Status attribute is simply a logical OR of all possible failure or alarm conditions 
for the point. 


Figure 5-11.12 Analog Input Point Object Status Attribute Operation 


Status Failures or Alarms 
for specific point 
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5-11.6.1.2 Owner Vendor ID, Owner Serial Number 


These attributes may be implemented in both the point and group objects. If implemented in 
both, the values shall be the same for the point objects and the group object that binds the point 
object. If a connection to this object is made using the Connection Manager, then the value for 
the Owner Vendor Id and Owner Serial Number shall be the Originator Vendor Id and 
Originator Serial Number contained in the Forward_Open request. These values shall be 
cleared when the connection is closed or deleted. 


5-11.6.1.3 Input Range 


The Input Range attribute determines the set of analog values within which the inputs may 
operate. The value of the Input Range affects the default and legal values that other attributes 
may have. 


Input Range is necessary only if the point may be switched to operate within different ranges, 
which changes the behavior of the point. For example, if the point is configured to operate from 
OV to 5V or from 4mA to 20mA, the variability of ranges will likely change the expected 
behavior of the Value attribute and perhaps change vendor specific attributes. 


5-11.6.1.4 Value Data Type 


The Value Data Type attribute determines the data type to be used by the attribute Value (and 
perhaps other attributes as well). If Value Data Type is not used, then Value defaults to INT. 
Value (and other attributes) may behave as REAL, USINT, or any other data type based upon 
the definition of Value Data Type, which ultimately provides the ability for the analog point to 
be defined in any length necessary. 
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Analog Output Point Object 
Class Code: OB hex 


The Analog Output Point (AOP) models the point level attributes and services of the analog 
outputs in a product. It can be used to model voltage output or parts of an analog I/O control 
module. Note that the term ”output” is defined from the network’s point of view. An output 
will consume data from the network. The Analog Output Point interface is to real output points 
such as a Motor Operated Valve (MOV) or Linear Positioner. The output is read from this 
object’s VALUE attribute and applied to the output terminal (e.g. screw terminal). 


Class Attributes 


Table 5-12.1 Analog Output Point Object Class Attributes 


Attr ID Need in Access Name Data [Pee] Description of Semantics of Values 
Implementation | Rule Attribute 
1 Required Revision fea Revision of this | The current value assigned 
object to this attribute is two 
(02). 


2 thru 7 | These class attributes are optional and are described in Chapter 4 of this specification. 
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5-12.2 Instance Attributes 


Table 5-12.2 Analog Output Point Object Instance Attributes 
Attr ID Need in 


Access Name Data Type | Description of Semantics of Values 
Implementation | Rule Attribute 
1 Optional Get Number of | USINT Number of 0-255 
Attributes attributes 
supported 
2 Optional Get Attribute Array of List of attributes 
List USINT supported by the 
point 


3 Required Set Value INT or based | Analog output 
on attribute 8 | value. The data 
et Status BOOL Indicates if a 0= operating without 

fault or alarm alarms or faults. 

has occurred. 1=alarm or fault condition 
exists, the Value attribute 
may not represent the actual 
field value. 


type defaults to 
INT but may be 
Owner - UINT Vendor ID of 
Vendor ID channel’s owner 
UDINT 32-bit serial 
number of 
channel’s owner 


Optional Set Output USINT Specifies the 0 = 4mA to 20mA 
Range output range the | 1 = 0V to 10V 
output channel | 2 = 0OmA to 20mA 
is to use 3 = -10V to 10V 
4=0Vto5V 
5 =-5V to 5V 
6=1Vto5V 
7 - 8 = Reserved 
9 = 0mA to 50mA 
10 — 99 = Reserved 
100-131=Vendor Specific 
132 — 254 = Reserved 
255 = Only return with 
Get_Attributes_All if 
attribute not supported 


8 Optional Set USINT Determines the | 0 = INT (default) 
data type of 1= REAL 
Value 2 = USINT 
3 = SINT 
4=DINT 
5 = LINT 
6 = UINT 
7 = UDINT 
8 = ULINT 
9 =LREAL 
100 = vendor specific 
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11 
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13 
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Need in Access Name Data Type 
Implementation | Rule 


Optional Fault USINT 
Action 
Idle Action | USINT 


Required if Fault 
Action is 
implemented 


Required if Idle 
Action is 
implemented 


Idle Value | INT or based 
on attribute 8 


Object 
State 


Set Fault Value | INT or based 
on attribute 8 


- 


USINT 


Description of 
Attribute 


Output value to 
go to on failure 
or fault 


Output value to 
go to on idle 
mode 


User defined 
value outputs go 
to in fault mode 
if Fault State = 


3, user specified 
value 


User defined 
value outputs go 
to in idle mode 
if Idle State = 3, 
user specified 
value 


Changes state of 
AOP to Idle 
Mode or Run 
Mode 


State of the 
object 


, Part 2 


Semantics of Values 


0 = hold last state (default) 
1 = low limit! 

2 = high limit 

3 = use Fault Value 

4 - 99 = reserved 

100 - 199 = vendor specific 
200 - 299 = reserved 


0 = hold last state (default) 
1 = low limit! 

2 = high limit 

3 = use Idle Value 

4 - 99 = reserved 

100 - 199 = vendor specific 
200 - 299 = reserved 


0 = idle 
1=run 


1 = Non-Existent 

2 = Available 

3 = Idle 

4 = Ready 

5 = Run 

6 = Recoverable Fault 

7 = Unrecoverable Fault 
255 = Reserved 


' All values 0, 1, 2, and 3 shall be supported when the Fault Action or Idle Action attributes are implemented 


Important: If the following optional instance attributes are not supported, the default attribute 
values below indicate the required behavior for instances of this object class: 


Table 5-12.3 Analog Output Point Default Values for Unsupported Attributes 


Attribute 


ID 
7 
8 
9 

10 

11 

12 


Default Value 


FoupurRange [0 
Value Das Dee [0 
Faucsae [0 
flee ‘Yo 


Fault Value minimum value of range (attribute 7) 


Idle Value 0 
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5-12.3 Common Services 


The Analog Output Object provides the following Common Services: 


Table 5-12.4 Analog Output Point Object Common Services 


Service | Need in Implementation 
Code Service Name Description of Service 


OEhex Get_Attribute_Single | Returns the contents of the specified 
attribute. 


10hex Set_Attribute_Single Modifies an attribute value. 


Olhex | Optional Optional Get_Attributes_All Returns a predefined listing of this 
objects attributes (See the 
Get_Attributes_All Response 
definition below) 


O2hex |n/a Optional Set_Attributes_All Modifies the contents of the 
attributes of the class or object. 


*The Get_Attribute_Single service is REQUIRED if any class attributes are implemented. 


See the Appendix A for definitions of these common services. 


5-12.3.1 Get_Attributes_All Response 


At the Class level, the order of the attributes returned in the “Object/service specific reply data” 
portion of the Get_Attributes_All response is as follows: 


Table 5-12.5 Get_Attributes_All Response Data — Class Level 
0 Revision (low byte) Default = 1 
Revision (high byte) Default = 0 
Max Instance (low byte) Default = 0 
Max Instance (high byte) Default = 0 
Max ID Number of Class Attributes (low byte) Default = 0 
Max ID Number of Class Attributes (high byte) Default = 0 
Max ID Number of Instance Attributes (low byte) Default = 3 


NLT ODO] ay RR] wl] Nyyr 


Max ID Number of Instance Attributes (high byte) Default = 0 


Important: Insert default values for all unsupported attributes. 


At the Instance level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows: 
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Table 5-12.6 Get_Attributes_All Response Data — Instance Level 


rar [wee [ans [ea [aes | me [oa | 


Value Data Type, default = 0 = INT 


1 Value (low byte) 
n Value (high byte) 
nt+1 Number of Attributes Default = 0 


Attribute List (attribute #1) 


Attribute List (attribute #m) 


a ae ae ee 


Owner Vendor ID (low byte) Default = 0 
Owner Vendor ID (high byte) Default = 0 
Owner Serial Number (low byte) Default = 0 
Owner Serial Number Default = 0 
Owner Serial Number Default = 0 
Owner Serial Number (high byte) Default = 0 
Output Range Default = 255 
Fault Action Default = 0 
Idle Action Default = 0 
Fault Value (low byte) 


‘ Fault Value (high byte) 
; Idle Value (low byte) 


Idle Value (high byte) 


Command Default = 0 


Object State Default = 255 


Important: Insert default values for all unsupported attributes. 


The default value of 255 must be returned for the Output Range attribute ONLY if it is not 
supported by the device. 


Important: If the instance attribute * Number of Attributes” is not supported, the default value 
of zero is to be inserted in its place and no members of the ”Attribute List” attribute will 
follow. 


5-12.3.2. Set_Attributes_All Request 


No settable attributes currently exist at the Class level for the Analog Output Point object. 


At the Instance level, the order of attributes passed in the Set_Attributes_AII request is as 
follows: 
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5-12.5 


Analog Output Point Object, Class Code: 0Brex 


Table 5-12.7 Set_Attributes_All Request Data — Instance Level 


0 


Value Data Type 

1 Value (low byte) 

n Value (high byte) 
N+1 Output Range 


Fault Action 
Idle Action 
Fault Value (low byte) 


Fault Value (high byte) 
Idle Value (low byte) 


Idle Value (high byte) 


Important: The Set_Attributes_All service is to be supported only if all settable attributes 
shown above are implemented as settable. 


Object—specific Services 


The Analog Output Point Object provides no Object-specific services. 


Behavior 


The State Transition Diagram in Figure 5-12.8 provides a graphical description of the events 
and corresponding state transitions. A subset of the states and events may be supported in an 
application, but the behavior must be consistent. 


The State Event Matrix in Table 5-12.9 lists all pertinent events and the corresponding action to 
be taken while in each state. A subset of the states and events may be supported in an 
application, but the behavior must still be consistent. 


Important: Events can occur simultaneously, but the Fault events have priority if they occur 
simultaneously with other events. In addition, if the Receive_Data event occurs simultaneously 
with any other event, the other event takes precedence. 
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Figure 5-12.8 State Transition Diagram for Analog Output Point Object 
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Note: LED = I/O Status LED 


The following SEM contains these states: 


e Non-Existent: module without power. 

e Available: AOP defaults configured, waiting for connection. 
e Idle: AOP in standby mode and does not apply received data. 
e Ready (to run): waiting for valid data to apply. 

e Run: AOP applying received data to its output. 

e Recoverable Fault: a recoverable fault has occurred. 

e Unrecoverable Fault: an unrecoverable fault has occurred. 
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The SEM also contains these events: 


Table 5-12.9 Analog Output Point Object Event Definitions 


This event Is 


Receive_Data an event that signals the reception of I/O data and causes the object to transition to 
the Run state. 


Receive_Fault an event that is internally generated and product-specific. The network does not 
know if a Fault has occurred. 


Receive_Idle the setting of the COMMAND attribute to the value 0 -or- within the Master/Slave 
paradigm the event signaled when the I/O connection object receives a Bit—Strobe 
or Poll Command message containing no application data 


Receive_Run the setting of the COMMAND attribute to the value 1 -or- within the Master/Slave 
paradigm the event signaled when the I/O connection object receives a Bit—Strobe 
or Poll Command message containing application data 


Apply_Attributes the Apply service of the I/O connection object the Analog Output Point object is 
connected to. Note: the application is responsible for validating the connection 
object’s attributes. 


Connection Deleted I/O connection deleted. 
Connection Transitions to I/O connection transitions to Established. 
Established 


Connection transitions to the | the expiration of the connection timer. 
Timed Out state 


The figure below is a conceptual illustration of the state machine for a typical output object 
(consuming application). The events listed above are represented by the dotted line labeled 
“state change.” 
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Figure 5-12.10 State Machine Illustration for Typical Analog Output Point Object 
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Table 5-12.11 State Event Matrix for the Analog Output Point Object 


State 


Event Non-Existent | Available Ready Recoverable | Unrecoverable 
Fault Fault 


Receive_Data Not applicable | Not applicable | Ignore event | LED Solid Accept Data |Ignore event | Ignore event 
Green, Accept 
Data, 
Transition to 
Run 


Receive_Fault Not applicable | Not applicable | Transition to |Transitionto | Transition to |Ignore event | Ignore event 
Recoverable | Recoverable | Recoverable 
Fault ? 


Fault 4 Fault 4 


Receive_Idle Not applicable | Not applicable | Ignore event | Transition to | Transition to | Transition to | Ignore event 
Idle * Idle * Idle ? 
Receive_Run Not applicable | Not applicable | Transition to | Ignore event | Ignore event | Transition to | Ignore event 
Ready Ready 


Return Error | Return Error 
(object state | (object state 


Return Error | Return Error Ignore event 


(object state | (object state 


Not applicable | Verify 
attributes, 


Apply_Attributes 


return results | conflict) conflict) conflict) conflict) 
Connection Not applicable | Ignore event |Transitionto |Transitionto | Transition to | Transition to | Ignore event 
Deleted Available Available Available Available 
Connection Not applicable |} Transition to | Return Error | Return Error | Return Error | Transition to | Ignore event 
Transition to Ready (object state | (object state | (object state | Ready 


Established conflict) conflict) conflict) 


Transition to | Ignore event | Ignore event 
Recoverable 


Transition to 


Not applicable | Not applicable | Transition to 
Recoverable 


Connection 
Transitions to 
Timed Out state Fault 


Get_Attribute Return Error | Return value | Return value | Return value | Return value | Return value | Ignore event 
(Object Does 
Not Exist) 

Set_Attribute Return Error | Accept value | Accept value | Accept value | Accept value | Accept value | Ignore event 
(Object Does 
Not Exist) 


1 - Fault: Hold Last State OR use Fault Value. 
2 - Idle: Hold Last State OR use Idle Value. 


Recoverable 


Fault Fault | 
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5-12.5.1.1 


5-12.5.1.2 


5-12.5.1.3 


Analog Output Point Object, Class Code: 0Brex 
Attribute Access Rules 


Except in the Non-Existent and Unrecoverable Fault states, all attributes are gettable or settable 
according to their access rules. 


Because the only required Instance attribute is Value, the only required behavior of a Analog 
Output Point is that it outputs an analog value within the defined range for value (see Instance 
Attribute 8). 


Optional attributes either provide more information about the AOP or alter the behavior of the 
output point. 


Status Attribute - Optional 


The optional Status attribute is simply a logical OR of all possible failure or alarm conditions 
for the point. 


Figure 5-12.12 Analog Output Point Object Status Attribute Operation 


Status Failures or Alarms 


for specific point 


Command Attribute — Optional 


The Command attribute explicitly controls whether the AOP is in the Run or Idle state. It has 
effect only when the Analog Output object is in the Idle, Ready, Recoverable Fault or Run 
states. While in the Available state, an attempt to set this attribute will result in an 
Object_State_Conflict error. A read (Get_Attribute_Single) of this attribute will result in a zero 
being returned always. 


Attributes Used to Determine Safe State 


These optional attributes define a “safe state” for the analog output point when in the Idle or 
Fault states: 


e Output Fault State 
e Output Fault Value 
e Output Idle State 

e Output Idle Value 


Table 5-12.13 Determining Output Value in Fault and Idle Conditions 


This attribute pair Defines 


Output Fault State and Output Fault Value the value of the AOP in the Recoverable Fault state 


Output Idle State and Output Idle Value the value of the AOP point when in the Idle state 


The following dependencies exist among these attributes: 


Table 5-12.14 Output Fault and Idle State Attribute Dependencies 


If this attribute is 
supported 


Then this attribute must also be supported by definition 


Output Fault State Fault Value (although this attribute could be defined to always be LOW). 
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5-12.5.1.5 


5-12.5.1.6 


Analog Output Point Object, Class Code: 0Brex 


Output Idle State Idle Value 


Owner VendorId, Owner Serial Number 


These attributes may be implemented in both the point and group objects. If implemented in 
both, the values shall be the same for the point objects and the group object that binds the point 
object. If a connection to this object is made using the Connection Manager, then the value for 
the Owner Vendor Id and Owner Serial Number shall be the Originator Vendor Id and 
Originator Serial Number contained in the Forward_Open request. These values shall be 
cleared when the connection is closed or deleted 


Output Range Attribute — Optional 


The Output Range attribute determines the set of analog values within which the outputs may 
operate. The value of the Output Range affects the default and legal values that other attributes 
may have. 


Output Range is necessary only if the point may be switched to operate within different ranges, 
which changes the behavior of the point. For example, if the point is configured to operate from 
-10V to 10V or from OV to 10V, the variability of ranges will likely affect the low value that 
outputs go to in safety state (you can use -10 V or 0 V, Output Range). 


Value Data Type Attribute — Optional 


The Value Data Type attribute determines the data type to be used by the attribute Value (and 
perhaps other attributes as well). If Value Data Type is not used, then Value defaults to INT. 
Value (and other attributes) may behave as REAL, USINT, or any other data type based upon 
the definition of Value Data Type, which ultimately provides the ability for the analog point to 
be defined in any length necessary. 
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5-13.1 


5-13.2 


Presence Sensing Object, Class Code: 0Epex 


Presence Sensing Object 
Class Code: 0E hex 


This object senses the presence or absence of a real world target. 


Class Attributes 


Table 5-13.1 Presence Sensing Object Class Attributes 
Attribute 


Need in Access Name Data Type | Description of 
ID Implementation | Rule Attribute 


1 thru 7 | These class attributes are optional and are described in Chapter 4 of this specification. 


Semantics of 
Values 


Instance Attributes 


Table 5-13.2 Presence Sensing Object Instance Attributes 


Attr Need in Access Name Data Type Description of Attribute Semantics of 
ID_ | Implementation | Rule Values 
1 Required Get Output BOOL 0 = switching element open | See Semantics” 
1 = switching element closed | section 
Optional Get Number of USINT Number of attributes 
Attributes supported 
Optional Get Attribute Array of List of attributes supported 
List USINT 
Optional Get Diagnostic BOOL 0=good 
1=fault 


On Delay UINT 0 — 65,535 ms 
Off Delay UINT 0 — 65,535 ms 
One Shot Delay | UINT 0 — 65,535 ms 


Optional Set Operate Mode | BOOL 0 = output attribute as See Semantics” 
specified section 
1 = inversion of output 
attribute 
Optional Set Sensitivity USINT 0-255 See Semantics” 
section 
Optional Get Target Margin | USINT 1-255 See Semantics” 
section 
Optional Get Background USINT 0 — 100 See Semantics” 
Margin section 
Optional Set Min Detect UINT 0 -— 65,535 mm See Semantics” 
Distance section 
Optional Set Max Detect UINT 0 -— 65,535 mm * See Semantics” 
Distance section 


* The Max Detect Distance must be greater than or equal to the Min Detect Distance 
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5-13.2.1.1 


5-13.2.1.2 


5-13.2.1.3 


5-13.2.1.4 


5-13.2.1.5 


Presence Sensing Object, Class Code: 0Epex 
Semantics 


Output 


The Output value is determined by the switching element in the device. The state of this value 
is controlled by the: 


e operation mode: Light Operate (LO)/Dark Operate (DO) 
Normally Closed (NC)/Normally Open (NO) 

e detection of an object (absence or presence) 

e timing 

e type of device (photoelectric, proximity) 


The following table indicates output values for common presence sensing devices. 


Table 5-13.3 Common Output Values for Presence Sensing Devices 


Output Values 


Presence Sensing Device Output = Off 
Diffuse Photoelectric, 


light detected (LO) no light detected (LO) 
Retroreflective Photoelectric no light detected (DO) light detected (DO) 
Through—Beam Photoelectric light beam detected (LO) light beam interrupted (LO) 
light beam interrupted (DO) light beam detected (DO) 
Inductive Proximity, Capacitive, | object present (NO) object absent (NO) 
Ultrasonic, Limit Switch object absent (NC) object present (NC) 
Operate Mode 
Use the Operate (Sensing) Mode to invert the level definition of the Output attribute. 


Table 5-13.4 Common Output Values for Presence Sensing Devices 


use the Operate Mode to: 
set Light Operate (LO)/Dark Operate (DO) mode. 
set Normally Open (NO)/Normally Closed (NC) mode. 


For 


photoelectric sensors, 


proximity sensors, 


Sensitivity 
Sensitivity is the amplification of the signal received by the detection device. Sensitivity is 
defined with either of two methods (i.e. low, medium, high or a numeric scale). This attribute 
accommodates both methods by converting the terms into a numeric scale 
(i.e. O = lowest, ... , n = highest). 


Target Margin 


Target Margin is the signal strength received by the device when the signal strength is above 
the device output switching threshold. The margin value is a scale of 1 to 255 with 1 
representing the device output switching threshold. 


Background Margin 


Background Margin is the signal strength received by the device when the signal strength is 
below the device output switching threshold. The margin value is a scale of 0 to 100 where the 
value 100 equals the device switching threshold and the value 0 represents no signal received. 
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5-13.2.1.6 Minimum and Maximum Detect Distances 


The Minimum and Maximum Detect Distances define the range in which an object can be 
detected. If an object passes through the sensing device’s field of view outside this range, the 
sensing device does not change the output (attribute number 1) of the device to indicate 
detection of that object. 


5-13.3 Common Services 
The Presence Sensing Object provides the following Common Services: 
Table 5-13.5 Presence Sensing Object Common Services 


Need in 
Service Implementation 


Code Service Name Description of Service 


OEhex Conditional* | Required | Get_Attribute_Single | Returns the contents of the 
specified attribute. 
10hex n/a Set_Attribute_Single Modifies an attribute value. 


*The Get_Attribute_Single service is REQUIRED if any attributes are implemented. 


See the Appendix A for definitions of these common services. 
5-13.4 Object—specific Services 


The Presence Sensing Object provides no Object—specific services. 


— 5-92 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 2 


Presence Sensing Object, Class Code: 0Epex 
5-13.5 Behavior 


The behavior of the Presence Sensing Object is illustrated in Figure 5-13.6, State Transition 
Diagram and Table 5-13.7, State Event Matrix. Table 5-13.8 indicates the accessibility of 
attributes. 


Figure 5-13.6 Presence Sensing Object State Transition Diagram 


Non-Existent 


Connection 
Established 


Connection 
Deleted 


Table 5-13.7 Presence Sensing Object State Event Matrix 


State 


Event Non-Existent Run 


Connection established | Transition to Run Ignore event 


Connection deleted Ignore event Transition to Non-Existent 


Get_Attribute_Single Ignore event Return value 


Set_Attribute_Single Ignore event Accept value 
Table 5-13.8 Presence Sensing Object Attribute Access 


State 


Attribute Non-Existent Running 


Output ot available Read Only 


Number of Attributes 
Attribute List 
Diagnostic 

On Delay 

Off Delay 

One Shot Delay 
Operate Mode 
Sensitivity 

Target Margin 
Background Margin 
Min Detect Distance 
Max Detect Distance 


Detect Distance 


ot available Read Only 
ot available Read Only 
ot available Read Only 
ot available Read/Write 
ot available Read/Write 
ot available Read/Write 
ot available Read/Write 
ot available Read/Write 
ot available Read Only 
ot available Read Only 
ot available Read/Write 
ot available Read/Write 


ot available Read Only 
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Parameter Object 
Class Code: OF hex 


Use of the Parameter Object provides a known, public interface to a device’s configuration 
data. In addition, this object also provides all the information necessary to define and describe 
each of a device’s individual configuration parameters. 


This object allows a device to fully identify a configurable parameter by supplying a full 
description of the parameter, including minimum and maximum values and a human-readable 
text string describing the parameter. 


There must be one instance of this object class for each of the device’s configurable 
parameters. The instances must start at instance one and increment by one with no gaps in the 
instances. 


Each instance is linked to one of the configurable parameters, which is typically (but is not 
required to be) an attribute of one of the device’s other objects. Changing the Parameter Value 
attribute of a Parameter Object causes a corresponding change in the attribute value indicated 
by the Link Path attribute (the attribute value being pointed to by the Parameter Object). 


For example, Instance #1 of the Parameter Object below identifies the parameter represented by 
the Analog Input Point (AIP) Object, Instance #1, Attribute #7. 


Figure 5-14.1 Parameter Object representation of an Analog Input Point Attribute 


Device 
AIP 
Instance #1 


Parameter 
Class 
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5-14.1 Class Attributes 


Table 5-14.2 Parameter Object Class Attributes 


Attrib Need in Access Name Data Type | Description of Semantics of Values 
ID Implementation | Rule Attribute 


1 This class attribute is optional and is described in Chapter 4 of this specification. 


2 Required Get Max Instance | UINT Maximum The largest instance 
instance number | number of a created 
of an object object at this class 
currently created | hierarchy level. 
in this class level 
of the device. 


3 thru 7 | These class attributes are optional and are described in Chapter 4 of this specification. 


8 Required Get Parameter WORD Bits that describe | See Table 5-14.3 
Class parameters. 
Descriptor 
9 Required Get Configuration | UINT Instance number | This attribute shall be set 
Assembly of the to zero if a configuration 
Instance configuration assembly is not 
assembly. supported. 


10 USINT Language ID for |0=English 


all character 1=French 
array accesses. 2=Spanish 

1. If the Active Language attribute of the Identity Object (attribute ID 11) is supported, then this attribute shall not 

be supported. 


3=Italian 

4=German 
5=Japanese 
6=Portugese 
7=Mandarin Chinese 


5-14.1.1 Semantics 
5-14.1.1.1 Parameter Class Descriptor 


The Parameter Class Descriptor attribute contains bits to describe parameter characteristics. 
The following bits are supported: 


Table 5-14.3 Parameter Class Descriptor Bit Values 


Bit Definition 
0 Supports Parameter 
Instances 
1 Supports Full Attributes 
2 Must do non-volatile 
storage save command 
3 Params are stored in 


Non-Volatile storage 
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5-14.1.1.1.1 Supports Parameter Instances, Bit 0 


“Supports Parameter Instances” indicates that Parameter Instances are present for 
each parameter. Parameter Instances contain all attributes or just the stub attributes. 
Bit values are: 


Table 5-14.4 “Supports Parameter Instance” Bit Values 


Meaning 


Individual Parameter instances ARE supported. 


NO Parameter Instances are supported. Only configuration assembly instance used. 


5-14.1.1.1.2 Supports Full Attributes, Bit 1 


“Supports Full Attributes” indicates that each Parameter Instance contains all of the attributes 
and are not just stubs. Bit values are: 


Table 5-14.5 “Supports Full Attributes” Bit Values 


Meaning 
All Full Parameter Attributes ARE supported. 


Only Parameter Instance stub attributes are supported. 


5-14.1.1.1.3. Must Do NV Storage Save Command, Bit 2 


“Must Do NV Storage Save Command” indicates that parameters are not stored into NV 
storage until a Save service is performed on the Parameter Object. 


Table 5-14.6 “Must Do VN Storage Save Command “Bit Values 


Meaning 


Must execute non-volatile storage save command. The Save service of 
the parameter class is used to save instance parameter values. 


Do not have to execute non-volatile storage save command. 


5-14.1.1.1.4 | Params Are Stored In Non-Volatile Storage, Bit 3 


“Params are stored in Non—-Volatile Storage” indicates that parameters are stored in non— 
volatile storage. Bit values are: 


Table 5-14.7 “Params are stored in Non-Volatile Storage” Bit Values 


Meaning 


All Full parameters are stored in non—volatile storage. 


Parameters are not stored in non—volatile storage. 


A Parameter Object Stub is a shorthand version of a parameter object. The stub stores only the 
configuration data value, providing only a standard access point for the parameter. 
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5-14.2 Instance Attributes 


Table 5-14.8 Parameter Object Instance Attributes 


eas Need in Access | Stub/ Name Data Type | Description of Attribute | Semantics of 
Implementation | Rule | pyy Values 


imi Parameter data type __| Actual value of parameter. It 
Value 


specified in | can be read from or written 
Descriptor, | to. This attribute is read— 
Data Type | only if bit 4 of Attribute #4 
and Data is TRUE. 

Size. 


2 Required Set Stub | Link Path USINT Size of link path. If this Number of 
Size attribute is 0, then no link is | bytes. 
specified. 
3 Required Stub | Link Path Packed CIP path to the object from | The Link Path 
EPATH where this parameter’s value | is limited to 
is retrieved. 255 bytes. 
See Appendix 
C. 
4 


Required Stub — | Descriptor WORD Description of parameter. See Table 
5-14.9 
Required Stub | Data Pee | EPATH Data type code. See Appendix 
C-6.1 
Stub —— Size USINT Number of bytes in 
Parameter Value 


eal SHORT__ | A human-readable string The 
STRING representing the parameter maximum 
name. For example, number of 
“Frequency #1” characters is 
16 


uo 


ido) 
c c 
— — 


6 Required 


7 
= 


Conditional ! 


N 


Name String 


8 Conditional * Engineering Unit String The 
maximum 


number of 


Units String |SHORT_ 
STRING 
characters is 4 
Conditional * Full Help String SHORT__ | Help String The 
STRING maximum 
number of 
characters is 
64 


10 | Conditional * Full Minimum data type Generally, the minimum See semantics 
Value value to which the parameter | section 
Full Maximum data type 
Value 


can be set. 5-14.2.1.3 
Default Value | data type 


11 | Conditional * Generally, the maximum See semantics 


value to which the parameter | section 
Cam Dersct 5-14.2.1.3 


The actual value the 
parameter should be set to 


12 Conditional ! 


when the user wants the 
default for the parameter. 


Full Scaling UINT Multiplier for Scaling Factor. | See Figure 
Multiplier 5-14.11 


13 | Conditional ! 
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ee Need in Access | Stub/ Name Data Type | Description of Attribute | Semantics of 
Implementation} Rule | pyy Values 


14 | Conditional * Full Scaling UINT 
Divisor 


: om |e 


uo 


(Can be 


negative) 


17 | Conditional ' Get Full Multiplier UINT 
Link 

: 

. ae 

21 


Conditional ! Full | Decimal US 
Precision 


Optional Get International | STRIN 
Parameter 
Name 

Optional Get International | STRIN 
Engineering 
Units 

Optional Get International | STRIN 
Help String 


Divisor for Scaling Formula. | See Figure 
5-14.11 
Base for Scaling Formula. See Figure 
5-14.11 
Offset for Scaling Formula. | See Figure 
5-14.11 
Parameter Instance of See Table 
Multiplier source. 5-14.16 
Parameter Instance of See Table 
Divisor source. 5-14.16 
Parameter Instance of Base _ | See Table 
source. 5-14.16 
Po jee Instance of Offset | See Table 
pe lee 5-14.16 


Specifies number of decimal 
places to use when 
displaying the scaled 
engineering value. Also used 
to determine actual 
increment value so that 
incrementing a value causes 
a change in scaled 
engineering value to this 
precision. 


Human readable string 
representing the parameter 
name 


Engineering units associated 
with the parameter 


Help String 


1 Required if the Parameter Object class descriptor bit 1 is set (supports full attributes). Not allowed if the Parmeter 


Object class descriptor bit 1 is not set. 
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5-14.2.1 Semantics 
5-14.2.1.1 Descriptor Attribute 


The Descriptor Instance Attribute contains these bits, which describe the parameter: 


Table 5-14.9 Semantics of Descriptor Instance Attribute 


Bit Meaning 

0 Indicates that link path can be set. 

1 Indicates that enumerated strings are supported and can be read with the 
Get_Enum_String service. 

2 Indicates that the scaling factor should be implemented to present the value to the 
user in engineering units. 

3 Indicates that the values for the scaling factor may be retrieved from other 
parameters. If the “Supports Scaling” descriptor bit is also set and the scaling link 
value is zero, the scaling value shall be used. If the “Supports Scaling” descriptor 
bit is also set and the scaling link value is not zero, the scaling link value shall be 
used. 

4 Indicates that the Parameter Value attribute can only be read, and not set. | 

5 Indicates that the Parameter Value attribute is updated in real time by the device. | 

6 Indicates that the extended precision scaling factor should be implemented to 
present the value to the user in engineering units. 

7 Obsolete. 

8 Obsolete. 

9 The configuration tool shall not display this parameter 

10 Indirect Parameter The parameter value represents the instance number of another parameter. The 

Reference referenced parameter instance shall not be an additional indirect reference. A 
parameter value of 0 shall indicate no reference. The data type for this parameter 
shall be USINT, UINT or UDINT. 

11 The parameter is not directly addressable from the network by any of the 
Set_Attribute or Get_Attribute services. 

12 This bit, when set, indicates that this parameter may be individually saved by 
sending the Save service to this parameter instance. 

13 This bit, when set, indicates the execution of the Apply serice to this parameter 
instance is required before attribute changes affect instance behavior. 

14 Indicates that the Parameter Value attribute can only be set, and not read. | 

15 This shall be set to zero | 
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5-14.2.1.2 Data Type Attribute 


The Data Type Instance Attribute specifies the data type of the parameter. This value shall be 
specified according to the format shown in Appendix C, Section C-6.1. The following data 
types are obsolete but may be encountered in older devices: 


Table 5-14.10 Obsolete Data Types Possible in the Parameter Object 


21 STRING2 16-bit per character string 

22 STRINGN N-byte per character string 
23 SHORT_STRING Short N-byte character string 
24 BYTE 8-bit string 

25 DWORD 32-bit string 

26 LWORD 64-bit string 


Attr Description 
Value 
1 16-bit word 
2 16-bit unsigned integer 
3 16-bit signed integer 
5 Short Integer 
6 Double Integer 
7 Long Integer 
8 Unsigned Short Integer 
9 Unsigned Double Integer 
10 Unsigned Long Integer 
11 Single floating point format (IEEE 754) 
12 Double floating point format (IEEE 754) 
13 Duration (short) 
14 Duration 
15 Duration (high resolution) 
16 Duration (long) 
17 Date (See Appendix J Volume I) 
18 Time of day (See Appendix J Volume I) 
19 Date and Time (See Appendix J Volume I) 
20 8-bit per character string 
STRING? 
STRINGN 
[SHORTSTRING | 
BYTE 
[DWORD 
|LWORD 


Obsolete data type codes shall not be valid in devices developed to this specification. 
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Minimum and Maximum Value Attributes 


Table 5-14.11 Minimum and Maximum Value Semantics 


Description and Minimum Value Maximum Value Reauiee! 
Data Type : a 3 Optional/ 
Semantics Semantics Semantics 
Not Allowed 
BYTE Bit String — 8 bit length The most significant bit that is set in the minimum Optional 
WORD Bit String — 16 bit length value is the lowest valid bit to be enumerated. The 
- - - most significant bit that is set in the maximum value is 
DWORD Bit String — 32 bit length | the highest valid bit to be enumerated. A minimum 
LWORD Bit String — 64 bit length | value of zero means that bit 0 is the lowest valid bit to 
be enumerated. A maximum value of zero is not valid. 
Example 1: 
Min value = 0b00001 
Max value = 0b01000 
Bits 0 — 3 are enumerated. 
Example 2: 
Min value = 0b00001 
Max value = 0b01011 
Bits 0 — 3 are enumerated, bits 0 and 1 
in max value are ignored. 
Example 3: 
Min value = 0b00000 
Max value = 0b01000 
Bits 0 — 3 are enumerated, 0 min value 
implies bit 0. 
STRING’ String Minimum string length Maximum string length Required 
(2 byte length indicator, 
1 byte per character) 
STRING2' | String Minimum string length Maximum string length Required 
(2 byte length indicator, 
2 bytes per character) 
STRINGN' | String Minimum string length Maximum string length Required 
(2 byte length indicator, 
N bytes per character) 
SHORT_ Character string Minimum string length Maximum string length Required 
STRING! | (1 byte length indicator, 
1 byte characters) 
STRINGI' | International Character Minimum length (in Maximum length (in Required 
String (see Appendix C characters) of the characters) of the 
for data type definition) “stringcontents” “stringcontents” 
component of the string’s component of the string’s 
implicit sequence implicit sequence 
EPATH' Encoded Path Minimum string length Maximum string length Optional 
ENGUNIT | Engineering Units The minimum value for The maximum value for Optional 


this data type is not 
defined and shall not be 
specified in the EDS file 
or the parameter object 
instance. 


this data type is not 
defined and shall not be 
specified in the EDS file 
or the parameter object 
instance. 


ODVA & ControlNet International, Ltd. 
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Description and Minimum Value Maximum Value peat 
Data Type A : : Optional/ 
Semantics Semantics Semantics 
Not Allowed 
All Other Data Types The minimum numeric The maximum numeric Optional? 


value that may be 
assigned to the data value. 


value that may be 
assigned to the data 
value. 


1 The STRING, STRING2, STRINGN, SHORT_STRING, STRINGI and EPATH data types do not 
have a minimum or maximum value specification. The minimum and maximum value fields are 
used to present the minimum and maximum string or path lengths. In these cases, the Data Size 
parameter is used to represent the number of bytes required per character or encoding entry. 

2 Ifthe Minimum Value and/or Maximum Value is not specified then the minimum and/or maximum 
value for the parameter data value are as defined in CIP Common, Appendix C, Table C-2.1 based 
on the parameter data type. 


Scaling Factor Attributes 


The Scaling Factor represents actual UINT and INT parameter values in other formats. Use the 
following formula to determine the engineering value from the actual value: 


Figure 5-14.12 Determining Engineering Value from Actual Value 


(ActualValue + Offset) * Mult * Base 
Div 


EngValue = 
The engineering value can then be displayed to the user in the terms specified within the 
Decimal Precision Instance Attribute. Use the inverse of the Scaling Formula to determine the 


actual value from the engineering value: 


Figure 5-14.13 Determining Actual Value from Engineering Value 


(EngValue * Div) 
Mult * Base 


ActualValue = - Offset 


The extended precision scaling factor adds extended precision to the standard scaling factor. 
Use this following formula to determine the engineering value from the actual value: 


Figure 5-14.14 Determining Engineering Value from Actual Value 


(ActualValue + Offset) * Mult * Base 
Div * 10QP recision 


EngValue = 
The engineering value can then be displayed to the user in the terms specified within the 
Decimal Precision attribute. Use the inverse of the extended precision scaling formula to 


determine the actual value from the engineering value: 


Figure 5-14.15 Determining Actual Value Using Precision and Scaling 


(EngValue * Div * 10°") 
Mult * Base 


ActualValue = - Offset 


For the scaling formula, the following attributes are required: 
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Table 5-14.16 Scaling Formula Attributes 


Attribute Meaning 

Multiplier Value | (Mult) Multiplier value for the scaling formula. This value can be based on another parameter. 

Divisor Value (Div) Divisor value for the scaling formula. This value can be based on another parameter 
specified in the Divisor Link. 

Base Value (Base) Base value for the scaling formula. This value can be based on another parameter 
specified in the Base Link. 

Offset Value (Offset) Offset value for the scaling formula. This value can be based on another parameter 
specified in the Offset Link. This attribute is an INT and can be negative. 

Decimal (Precision) Precision value for the scaling formula. This value cannot be based on another 

Precision parameter. 


Scaling values (multiplier, divisor, base, and offset) can also be based on other parameters. 
Scaling Links specify from which instance that scaling value is to be retrieved. If the scaling 
link attribute is set to 0, then that scaling value is a constant and not linked to another 
parameter. The following attributes specify scaling links: 


Table 5-14.17 Scaling Links 


Attribute Meaning 
Multiplier Link Specifies the parameter instance from where the Multiplier Value is retrieved. 
Divisor Link Specifies the parameter instance from where the Divisor Value is retrieved. 
Base Link Specifies the parameter instance from where the Base Value is retrieved. 
Offset Link Specifies the parameter instance from where the Offset Value is retrieved. 
5-14.3 Common Services 


The Parameter Object provides the following Common Services: 


Table 5-14.18 Parameter Object Common Services 


Service | Need in Implementation 
Code Instance Service Name Description of Service 


Causes parameter values whose use is pending 
to become actively used. 


OEhex Required Get_Attribute_Single | Returns the contents of the specified attribute. 
10hex Required Set_Attribute_Single | Modifies an attribute value. 


Returns a predefined listing of this objects 

O1hex | Optional Conditional’ | Get_Attributes_All attributes (See the Get_Attributes_All Response 
definition below) 

OShex | Optional ale eset Resets all parameter values to the factory 
default. 

[conditions| | Restores all parameter values from non-volatile 

storage. 

15hex Restore 

a, 2 Restores parameter instance value from non- 
Conditional : 

volatile storage. 
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Service | Need in Implementation 
Code Service Name Description of Service 


2 Saves all parameter values to non—volatile 
Conditional ** P 


storage. 


16hex ea Save : - 
nee Saves parameter instance value to non-volatile 
Conditiona storage 
ie Returns the content of a selected member of an 
18hex Conditional’ | Get_Member tariwire 


1) The Get_Member service is required if any attributes with the International String (STRINGI) data type are 
implemented. 


2) The Save and Restore services are optional. However, implementing either service requires implementation of 
both services. 


3) If the Save and Restore services are implemented at the instance level, these services shall also be implemented 
at the class level. 


4) Optional for Parameter Object Stubs, required for Full parameter Objects. 


See the Appendix A for the definition of these common services. 


Get_Attributes_All Response 


” 


At the Class level, the order of the attributes returned in the “Object/service specific reply data 
portion of the Get_Attributes_All response is as follows: 


Table 5-14.19 Get_Attributes_All Response Service Data 
0 Revision (low byte) Default = 1 
Revision (high byte) Default = 0 

Max Instance (low byte) 

Max Instance (high byte) 
Parameter Class Descriptor (low byte) 
Parameter Class Descriptor (high byte) 

Configuration Assembly Instance (low byte) 


Configuration Assembly Instance (high byte) 


COIPN]T Dm] oy R] WIN re 


Native Language Default = 0 


Important: Insert default values for all unsupported attributes. 


At the Instance level, the setting of the Parameter Class Descriptor attribute dictates what 
attributes are returned by the Get_Attributes_All service: 


Table 5-14.20 Effect of Descriptor Attribute on Get_Attributes_All Response 


If the Parameter Class Then: 
Descriptor Attribute: 


does NOT have the “Supports | only the implemented attributes marked Stub (attribute numbers 1-6) are returned 
Full Attributes” bit set, by the Get_Attribute_All service 


DOES have the “Supports Full | The Get_Attribute_All service returns all implemented attributes (numbers 1—24) 
Attributes” bit set, 
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For Parameter object Stubs, the order of the attributes returned in the “Object/service specific 
reply data” portion of the Get_Attributes_All response is as follows: 


Table 5-14.21 Get_Attributes_All Response Service Data for Parameter Object Stub 


Cana [aes [aes ae em | 


Parameter Value (low byte) 


Parameter Value (high byte) 
Link Path Size 
Link Path (1st byte) 


Link Path (last byte) 
Descriptor (low byte) 
Descriptor (high byte) 

Data Type 
Data Size 


For Full Parameter objects, the order of the attributes returned in the “Object/service specific 
reply data” portion of the Get_Attributes_All response is as follows: 


Table 5-14.22 Get_Attributes_All Response Service Data for Full Parameter Object 


0 Parameter Value (low byte) 


n Parameter Value (high byte) 
n+1 Link Path Size 
Link Path (1st byte) 


Link Path (last byte) 
Descriptor (low byte) 
Descriptor (high byte) 
Data Type 
Data Size 
Parameter Name String (charcount) Default = 0 


Parameter Name String (1st byte) 


Parameter Name String (last byte) 
Units String (charcount) Default = 0 
Units String (1st byte) 


Units String (last byte) 
Help String (charcount) Default = 0 
Help String (1st byte) 


Help String (last byte) 
Minimum Value (low byte) Default = 0 


Minimum Value (high byte) Default = 0 
Maximum Value (low byte) Default = 0 
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: Maximum Value (high byte) Default = 0 
Default Value (low byte) Default = 0 
Default Value (high byte) Default = 0 

Scaling Multiplier (low byte) Default = 1 
Scaling Multiplier (high byte) Default = 0 
Scaling Divisor (low byte) Default = 1 
Scaling Divisor(high byte) Default = 0 
Scaling Base (low byte) Default = 1 
Scaling Base (high byte) Default = 0 
Scaling Offset (low byte) Default = 0 
Scaling Offset (high byte) Default = 0 
Multiplier Link (low byte) Default = 0 
Multiplier Link (high byte) Default = 0 
Divisor Link (low byte) Default = 0 
Divisor Link (high byte) Default = 0 
Base Link (low byte) Default = 0 
Base Link (high byte) Default = 0 
Offset Link (low byte) Default = 0 
Offset Link (high byte) Default = 0 
Decimal Precision Default = 0 
International Parameter Name [See note below] 
International Engineering Units [See note below] 
International Help String [See note below] 


Note: For a device that has implemented the International String attributes, the Parameter Name character 
count, the Units String character count and the Help String character count shall be reported as zero. For 
device’s that do not support the International String attributes, each (and every) International String 
attributes shall be reported as a single byte of zero, or may be missing from the response. If any 
International String attribute is supported, all three attributes shall be reported in the response. 


5-14.4 Object—specific Services 
The Parameter Object provides the following Object—specific service: 


Table 5-14.23 Parameter Object Specific Services 


Service Need in Service Name Description of Service 
Code Implementation 
4Bhex |n/a Optional | Get_Enum_String Use this service to read enumerated strings from 
the Parameter Instance. See below. 


Enumerated strings are human-readable strings that describe either a bit or a value, depending 
on the parameter’s data type. 
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Table 5-14.24 Enumerated Strings Type versus Parameter Data Type 


If the parameter’s data type is: Then the enumerated strings returned are: 
BYTE, WORD, DWORD, LWORD _| Bit enumerated strings. 
USINT, SINT, UINT, INT, BOOL Value enumerated strings. 
All Other Data Types Invalid for enumeration 


If the parameter’s data type is BYTE, WORD, DWORD or LWORD, requesting a 
Get_Enum_String service with an enumerated string number of 0 on a parameter returns a 
SHORT_STRING that describes bit 0. Requesting a Get_Enum_String service with an 
enumerated string number of 1 on a parameter returns a SHORT_STRING that describes bit 1. 
This continues up to the maximum bit number supported by the parameter. 


If the parameter’s data type is SINT, USINT, INT, UINT or BOOL, requesting a 
Get_Enum_String service with an enumerated string number of 0 on a parameter returns a 
SHORT_STRING that describes the value of 0. Requesting a Get_Enum_String service with an 
enumerated string number of 1 returns aSHORT_STRING that describes the value of 1. 


The following parameters are defined for the Get_Enum_String service: 


Table 5-14.25 Parameters for Get_Enum_String Request 


Name Data Description of Attribute Semantics of Values 
Type 
Enumerated USINT _ | Number of Enumerated Maximum possible range of values = 0 to 255. 
String Number String to retrieve. Value indicates bit offset (relative to zero) for bit 


enumerations, actual value (relative to zero) for 
value enumerations. 


Table 5-14.26 Parameters for Get_Enum_String Response 


Name Data Description of Attribute Semantics of Values 
Type 
Enumerated SHORT_ | Enumerated Strings Maximum number of characters = 16 
String STRING 


5-14.5 Behavior 


The behavior of the Parameter Object is illustrated in the State Transition Diagram and State 
Event Matrix below. 


Figure 5-14.27 Parameter Object State Transition Diagram 


Get_Attribute_Single/ 
Power Up Get_Attributes_All 
Reset 
Restore 
Save 
Existent Get_Enum_String 
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Table 5-14.28 Parameter Object State Event Matrix 


State 


Event Existent 


Get_Attribute_Single Validates/service the request and 


returns the appropriate response. 
Set_Attribute_Single 
Get_Attributes_All 
Reset 

Restore 


Save 


Get_Enum_String 
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5-15.1.1 
5-15.1.1.1 


5-15.1.1.2 


Parameter Group Object, Class Code: 10yex 


Parameter Group Object 
Class Code: 10 hex 


The Parameter Group Object identifies and provides access to groups of parameters in a device. 
Grouping parameters provides convenient access to related sets of parameters. 


There must be one instance of this object class for each of the device’s parameter groups. The 
instances must start at instance one and increment by one with no gaps in the instances. 


Each Parameter Group Object contains a list of member Parameter Object Instances. Use the 
Get_Attribute service to access these parameter object instances by number. 


Class Attributes 


Table 5-15.1 Parameter Group Object Class Attribute 


Attribute Need in Access Name |DataType| Descriptionof | Semantics of Values 
ID Implementation | Rule Attribute 
object 


2 Required Get Max UINT Maximum instance | The largest instance 
Instance number of an number of a created 
object currently object at this class 
created in this class | hierarchy level. 
level of the device. 


3 thru 7 | These class attributes are optional and are described in Chapter 4 of this specification. 


8 Optional Set Native Language ID for all | O=English 
Language STRING accesses. | 1=French 

2=Spanish 
3=Italian 
4=German 
5=Japanese 
6=Portugese 
7=Mandarin Chinese 


Semantics 


Revision — Class Attribute #1 


The revision of the Parameter Group Object Class can be either 1 or 2, based upon the presence 
of the extended static attribute field. 


If the value is 01, then this attribute is OPTIONAL in implementation and the abbreviated 
static attribute set layout is required to exist in all instances. If the value is greater than 01, then 
this attribute is REQUIRED and the extended static attribute set is defined to exist within all 
instances. 


Native Language — Class Attribute #8 


The Native Language attribute is only used in revision 1 implementations of the Parameter 
Group. This attribute selects the language that will be presented in each instance’s Group 
Name String attribute. 
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Instance Attributes, Abbreviated Static Set 


This attribute layout only exists when the Parameter Group revision is one. 


Table 5-15.2 Parameter Group Object Instance Attributes, Abbreviated Static Set 


Attr ID Need in Access Name Data Description of Attribute | Semantics of 
Implem Rule Type Values 


1 Required Get Group Name SHORT_ | A human-readable string | Maximum 
String STRING | representing the group number of 
name (e.g., Setup, characters = 16 
Frequency Set) 
2 Required Get Number of UINT Number of parameters in 
members in group group 
3 Required Get 1st Parameter UINT Parameter Instance 
Number in Group Number 
4 Required Get 2nd Parameter UINT Parameter Instance 
Number in Group Number 


n Required Get (n—2)th Parameter | UINT Parameter Instance 
Number in Group Number 


The Parameter Number specifies the Parameter Instance of the nth member of a particular 
Parameter Group. Perform a Get_Attribute service on this attribute to receive the Parameter 
Instance Number associated with the particular group member. 


Instance Attributes, Extended Static Set 


This attribute layout only exists when the Parameter Group revision is greater than one. 


Table 5-15.3 Parameter Group Object Instance Attributes, Extended Static Set 
Attr ID Need in Access Name Data Description of Attribute Semantics of 
Implem Rule Type Values 
1 Required Get Group Name SHORT_ | A human-readable string Maximum 
String STRING | representing the group name __| number of 
(e.g., Setup, Frequency Set) | characters=16 
2 Required Get Number of UINT Number of parameters in 
members in group group 


3 Optional International a One or more international 
Group Name language strings representing 
the name of the parameter 
a 


4-15 [Reserved | 


16 a + —_—_— Parameter —— Parameter Instance a 
Number in Group 

17 Required 2nd Parameter UINT Parameter Instance Number 
Number in Group 


n Required Get (n-15)th Parameter | UINT Parameter Instance Number 
Number in Group 
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Common Services 


The Parameter Group Object provides the following Common Services: 


Table 5-15.4 Parameter Group Object Common Services 


Need in 
Service Implementation 
Code Service Name Service Description 


OEhex Get_Attribute_Single | Returns the contents of the specified attribute. 


Olhex |Optional | Optional | Get_Attributes_All Returns a predefined listing of this objects 
attributes (See the Get_Attributes_All Response 
definition below) 

10hex Set_Attribute_Single | Modifies an attribute value. 


See Appendix A for definitions of these common services. 


Get Attributes_All Response 


” 


At the Class level, the order of the attributes returned in the “Object/service specific reply data 
portion of the Get_Attributes_All response is as follows: 


Table 5-15.5 Get_Attributes_All Response Data, Class Level 


0 Revision (low byte) Default = 1 
1 Revision (high byte) Default = 0 
2 Max Instance (low byte) 

3 Max Instance (high byte) 

4 Native Language Default = 0 


Abbreviated Static Set instance - At the Instance level, the order of the attributes returned in 
the “Object/service specific reply data” portion of the Get_Attributes_All response for an 
Abbreviated Static Set instance is as follows: 


Table 5-15.6 Get_Attributes_All Response Data, Instance Level - Abbrev. Static Set 


Pace [ais [ae [oer 


Group Name (charcount) 


Group Name (1st character) 


n Group Name (last character) 
N+1 Number of members in group (low byte) 
Number of members in group (high byte) 
1st Parameter number in group (low byte) 


1st Parameter number in group (high byte) 


‘ last Parameter number in group (low byte) 
: last Parameter number in group (high byte) 
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Extended Static Set instance - At the Instance level, the order of the attributes returned in the 
“Object/service specific reply data” portion of the Get_Attributes_All response for an Extended 
Static Set instance is as follows: 


Table 5-15.7 Get_Attributes_All Response Data, Instance Level - Extended Static Set 


Cae [aes [ae ae | 


Group Name (International String) 


Group Name (second octet) 


n Group Name (last octet) 
n+1 Reserved — shall be reported as zero 
n+2 Number of members in group (low byte) 


Number of members in group (high byte) 
1st Parameter number in group (low byte) 


1st Parameter number in group (high byte) 


: last Parameter number in group (low byte) 
; last Parameter number in group (high byte) 
5-15.5 Object—specific Services 


The Parameter Group Object provides no Object-specific services on either the Class level or 
Instance level. 


5-15.6 Behavior 


The behavior of the Parameter Group Object is illustrated in the State Transition Diagram and 
State Event Matrix below. 


Figure 5-15.12 Parameter Group Object State Transition Diagram 


Power Up 
Get_Attribute_Single/ 
Set_Attribute_Single 


Existent 


Table 5-15.13 State Event Matrix for Parameter Group Object 


State 


Event Existent 


Get_Attribute_Single Validates/services the request and 


returns the appropriate response. 


Set_Attribute_Single 
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Group Object 
Class Code: 12 hex 


The Group Object binds other objects, typically discrete and analog, including AIP, AOP, AIG, 
AOG, DIP, DOP, DOG, or DIG. The objects bound to the Group must support the same 
attributes and services that apply to all of the bound objects (both inputs and outputs, discrete 
and analog) in a product. 


You must establish the list of groups and/or points bound to the Group at power-up, as the 
Binding List is static and a Get—only attribute of the Group. 


When to use the Group Object: 

e when many attributes are shared among many analog and/or discrete input and output 
points and/or groups. 

e to more efficiently access data by supporting services that may affect all members of the 
group. 

Figure 5-16.1 Group Object Application 


Class Attributes 


Table 5-16.2 Group Object Class Attributes 


Need in Access Name Data Type Description of 
Implementation | Rule Attribute 


These class attributes are optional and are described in Chapter 4 of this specification. 


Number Semantics of Values 
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5-16.2 Instance Attributes 


Table 5-16.3 Group Object Instance Attributes 


Attr | Needin | Access Name Data Type Description of Attribute Semantics of 
ID |Implement| Rule Values 
1 Optional Get Number of USINT Number of attributes supported 
Attributes by the group 
2 ARRAY of List of attributes supported 
USINT 


3 Optional Get Number of Number of points in a group 
Bound 
Instances 
4 Optional Get Binding ARRAY of List of instances in group 
STRUCT: 


Class ID UINT 


5 Optional Get Status BOOL Group is operating without 0=good; 
alarms or faults 1=alarm state 
6 Optional Get Owner - UINT Vendor ID of group’s owner 
Vendor ID 
7 Optional Get Owner - Serial | UDINT 32-bit serial number of 
Number group’s owner 


5-16.3 Common Services 


The Group Object provides the following Common Services: 


Table 5-16.4 Group Object Common Services 


Service Need In Implementation Service Name Description of Service 
Code Class Instance 
OE hex | Conditional * | Required Get_Attribute_Single | Returns the contents of the specified attribute 
01 hex Optional Optional Get_Attributes_All Returns a predefined listing of this object’s 
attributes (See the 
Get_Attributes_All_ Response definition 
below) 


* 
The Get_Attribute_Single service is REQUIRED if any attributes are implemented. 


See Appendix A for definitions of these services. 


5-16.3.1 Get_Attributes_All Response 


At the Class level, the order of the attributes returned in the “Object/service specific reply 
data” portion (see Chapter 4 for a description of the Service Data field) of the 
Get_Attributes_All response is as follows: 
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Table 5-16.5 Get_Attributes_All Service Data — Class Level 


0 Revision (low byte) Default = 1 
Revision (high byte) Default = 0 
Max Instance (low byte) Default = 0 
Max Instance (high byte) Default = 0 
Max ID Number of Class Attributes (low byte) Default = 0 
Max ID Number of Class Attributes (high byte) Default = 0 
Max ID Number of Instance Attributes (low byte) Default = 0 
Max ID Number of Instance Attributes (high byte) Default = 0 


NP OPO], RR] Ww] MpyeR 


Important: Insert default values for all unsupported attributes. 


At the Instance level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows: 


Table 5-16.6 Get_Attributes_All Service Data - Instance Level 


Cae [ona [ne | ae | 
Number of Attributes Default = 0 
Attribute List (attribute #1) 


n Attribute List (attribute #m) 
n+1 Number of Bound Instances Default = 0 
Binding: Class ID #1 (low byte) 
Binding: Class ID #1 (high byte) 
Binding: Instance ID #1 (low byte) 
Binding: Instance ID #1 (high byte) 


Binding: Class ID #m (low byte) 
Binding: Class ID #m (high byte) 
Binding: Instance ID #m (low byte) 
Binding: Instance ID #m (high byte) 
Owner Vendor ID (low byte) Default = 0 
Owner Vendor ID (high byte) Default = 0 
Owner Serial Number (low byte) Default = 0 
Owner Serial Number Default = 0 
Owner Serial Number Default = 0 
Owner Serial Number (high byte) Default = 0 


Important: Insert default values for all unsupported attributes. 


Important: If the instance attribute * Number of Attributes” is not supported, the default value 
of zero is to be inserted in its place and no members of the ”Attribute List” attribute will 
follow. 


Important: If the instance attribute ” Number of Bound Instances” is not supported, the default 
value of zero is to be inserted into the response byte array and no Binding data will follow. 
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Object-specific Services 


The Group Object provides no Object-specific services. 


Behavior 


The primary purpose of the Group Object is to bind Analog and Discrete Groups and/or Points. 
An attribute of the Group will modify the behavior or report additional status information of all 
objects bound to the group. 


The State Transition Diagram (STD) below illustrates the Behavior of a Group Object. The 
states shown are equivalent to the following: 


Table 5-16.7 Group Object State Definitions 


This state Is equivalent to 
Non-Existent | a module without power 
a module that has an unrecoverable fault (e.g. processor watchdog timeout) 


a major reconfiguration of the module (e.g. NVS Update) 


Binding when groups and/or points are added or bound to the Group (executed as part of Power Up cycle) 
Run the point at which Get and Set attribute services can be used to access the attributes of the Group 
Object 


Figure 5-16.8 Group Object State Transition Diagram 


Power Down 
(any state) 


Non-existent 


Binding 


Binding 
Established 
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5-16.5.1.1 


5-16.5.1.2 


Group Object, Class Code: 12x 
Attribute Access Rules 


All attributes are gettable or settable according to their attribute access rules, but only in the 
Run state. 


Status Attribute 


The Status attribute is simply a logical OR of all possible failure or alarm conditions for all 
points bound to the group. 


Figure 5-16.9 Group Object Status Attribute Operation 


Status 
Failures or Alarms 
for all points 


Owner Vendor ID, Owner Serial Number 


These attributes may be implemented in both the point and group objects. If implemented in 
both, the values shall be the same for the point objects and the group object that binds the point 
object. If a connection to this object is made using the Connection Manager, then the value for 
the Owner Vendor Id and Owner Serial Number shall be the Originator Vendor Id and 
Originator Serial Number contained in the Forward_Open request. These values shall be 
cleared when the connection is closed or deleted. 
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5-17.1 


Discrete Input Group Object, Class Code: 1Dyex 


Discrete Input Group Object 


Class Code: 1D hex 


The Discrete Input Group (DIG) Object binds a group of discrete input points in a module. All 
points bound to the group share all attributes contained in the group. If an attribute is shared 
(points have the same attributes and the same attribute values) across more than one Discrete 
Input Point (DIP), then that attribute can be contained in a Discrete Input Group. A Discrete 
Input Point can be bound to more than one Discrete Input Group. 


You must establish the list of discrete input points bound to the group at power-up, as the 
binding list is static and is a Get—only attribute of the group. 


When to use the Discrete Input Group Object: 


e when a single attribute is shared among many input points. 


e to more efficiently access data (services that affect all members of a group 
can be supported by the DIG). 


Figure 5-17.1 Discrete Input Group Object Application 


a % 


Class Attributes 


Table 5-17.2 Discrete Input Group Object Class Attributes 


Need in Access Name Data Type Description of 
Implementation | Rule Attribute 


These class attributes are optional and are described in Chapter 4 of this specification. 


Semantics of 
Values 


1 thru 7 
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5-17.2 


5-17.3 


5-17.3.1 


5-17.4 


Discrete Input Group Object, Class Code: 1Dyex 


Instance Attributes 


Table 5-17.3 Discrete Input Group Object Instance Attributes 


Attr | Needin | Access Name Data Type Description of Attribute Semantics of 
ID Impl Rule Values 
1 Optional | Get Number of USINT Number of attributes supported 
Attributes by the device 
2 Optional | Get Attribute List | ARRAY of List of attributes supported by 
USINT the device 


3 Optional | Get Number of Number of points bound to this 
Bound group 
Instances 
4 Optional | Get Binding ARRAY of: | List of all points bound to this Class DIP 
group Instance #X 
Class DIP 
Instance ID 
UINT Instance #Y... 
5 Optional | Get Status BOOL Status for all discrete input points | 0 = OK 
in the group 1 = Product 
specific alarm or 
status 


6 Optional | Set Off_On Delay | UINT filter time for off to on transition | The default 
7 Optional | Set On_Off Delay | UINT filter time for on to off transition | The default 


1 The input must be on for the amount of filter time specified by the OFF_ON DELAY attribute before the ON 
state is recorded in the VALUE attribute. 

2 The input must be off for the amount of filter time specified by the ON_OFF DELAY attribute before the OFF 
state is recorded in the VALUE attribute. 


Semantics 


On_OffDelay, Off_OnDelay 


When any of these attributes are implemented at the Group level, the corresponding attribute of 
the point objects bound to the group shall assume the value of the Group level object attribute. 
The attribute shall be implemented at the point level and shall be “Get” only. 


Common Services 


The Discrete Input Group Object provides the following Common Services: 
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Table 5-17.4 Discrete Input Group Object Common Services 


Service | Need In Implementation Service Name Description of Service 
Code Class Instance 

OE hex | ¢ sndidional Required Get_Attribute_Single | Returns the contents of the specified attribute 

10 hex N/A Optional Set_Attribute_Single | Modifies an attribute value 

01 hex Optional Optional Get_Attributes_All Returns a predefined listing of this object’s 
attributes (See the Get_Attributes_All_Response 
definition below) 

02 hex N/A Optional Set_Attributes_All Modifies the contents of the attributes of the 


class or object. 


* 
The Get_Attribute_Single service is REQUIRED if any attributes are implemented. 
See Appendix A for definitions of these services. 


5-17.4.1_ Get_Attributes_All Response 


At the Class level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows: 


Table 5-17.5 Get_Attributes All Response Data — Class Level 


0 


OLMOINI DI HIRI WInNnitr 


Revision (low byte) Default = 1 
Revision (high byte) Default = 0 


Max Instance (low byte) Default = 0 
Max Instance (high byte) Default = 0 


Number of Instances (low byte) Default = 0 


Number of Instances (high byte) Default = 0 


Max ID Number of Class Attributes (low byte) Default = 0 
Max ID Number of Class Attributes (high byte) Default = 0 
Max ID Number of Instance Attributes (low byte) Default = 0 


Max ID Number of Instance Attributes (high byte) Default = 0 


Important: Insert default values for all unsupported attributes. 


At the Instance level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows: 


Table 5-17.6 Get_Attributes_All Response Data — Instance Level 


Number of Attributes Default = 


n+1 


Attribute List (attribute #1) 


Attribute List (attribute #m) 


Number of Bound Instances Default = 0 
Binding : Instance ID #1 (low byte) 
Binding : Instance ID #1 (high byte) 


; Binding : Instance ID #m (low byte) 
; Binding : Instance ID #m (high byte) 
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Off_On Delay (low byte) Default = 

Off_On Delay (high byte) Default = 0 
On_Off Delay (low byte) Default = 0 
On_Off Delay (high byte) Default = 0 


Important: Insert default values for all unsupported attributes. 
Important: If the instance attribute ” Number of Attributes” is not supported, the default value 


of zero is to be inserted in its place and no members of the ”Attribute List” attribute will 
follow. 


Important: If the instance attribute ” Number of Bound Instances” is not supported, the default 
value of zero is to be inserted into the response byte array and no Binding data will follow. 


5-17.4.2.  Set_Attributes_All Request 
No settable attributes currently exist at the Class level for the Discrete Input Group Object. 


At the Instance level, the order of attributes passed in the “Object/service specific request 
data” portion of the Set_Attributes_AIl request is as follows: 


Table 5-17.7 Set_Attributes_All Request Service Data — Instance Level 


Byte Bit 7 Bit 6 Bit5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
0 Off_On Delay (low byte) Default = 0 
1 Off_On Delay (high byte) Default = 0 
2 On_Off Delay (low byte) Default = 0 
3 On_Off Delay (high byte) Default = 0 


Important: The Set_Attributes_All service is to be supported only if all settable attributes 
shown above are implemented as settable. 


5-17.5 Object—specific Services 


The Discrete Input Group Object does not support any Object—specific services. 


5-17.6 Behavior 


The primary purpose of the DIG is to bind discrete input points. 


An attribute of the DIG will modify the behavior or report additional status information of all 
DIPs bound to the group. 


The State Transition Diagram below provides a graphical description of the events and 
corresponding state transitions. A subset of the states and events may be supported in an 
application, but the behavior must be consistent. 
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The states shown are equivalent to the following: 


Table 5-17.8 Discrete Input Group Object State Definitions 


This state Is equivalent to 
a module without power 
Non-Existent a module that has an unrecoverable fault (e.g. processor watchdog timeout) 
a major reconfiguration of the module (e.g. NVS Update) 


Binding when discrete input points are added or bound to the Discrete Input Group 
(executed as part of Power Up cycle) 


Run the point at which Get and Set attribute services can be used to access the 
attributes of the Group Object 


Figure 5-17.9 State Transition Diagram for Discrete Input Group Object 


Non-Existent — am Power Down 


(any state) 


Power Up 


Binding 
Established 


5-17.6.1 Attribute Access Rules 


All attributes are gettable or settable according to their attribute access rules, but only in the 
Run state. 


5-17.6.1.1 Status Attribute 


The Status attribute is simply a logical OR of all possible failure or alarm conditions for all 
points bound to the group. 


Figure 5-17.10 Discrete Input Group Object Status Attribute Operation 


Status 


Failures or Alarms 
for all points 
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5-18.1 


Discrete Output Group Object, Class Code: 1E Hex 


Discrete Output Group Object 
Class Code: 1E hex 


The Discrete Output Group (DOG) Object binds a group of discrete output points in a module. 
All points bound to the group share all attributes contained in the group. If an attribute is 
shared across more than one Discrete Output Point (DOP), then it can be contained in a 
Discrete Output Group. A Discrete Output Point can also be bound to more than one Discrete 
Output Group. 


You must establish the list of discrete output points bound to the group at power-up, as the 
binding list is static and is a Get—only attribute of the group. 


When to use the Discrete Output Group Object: 


e when a single attribute is shared among many output points. 


e to more efficiently access data (services that affect all members of a group can be 
supported by the DOG). 


Figure 5-18.1 Discrete Output Group Object Application 
eee 


Class Attributes 


Table 5-18.2 Discrete Output Group Object Class Attributes 


Need in Name Data Type | Description of Attribute 
Implementation 


These class attributes are optional and are described in Chapter 4 of this specification. 


Attribute Semantics of 


Values 
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5-18.2 Instance Attributes 


Table 5-18.3 Discrete Output Group Object Instance Attributes 


Attr ID Need in Access Name Data Type | Description of Attribute | Semantics of 
Implementation | Rule Values 
1 Optional Get Number of USINT Number of attributes 
Attributes supported by the device 


2 Optional Get Attribute List | ARRAY of | List of attributes 
USINT supported by the device 
3 Optional Get Number of USINT Number of points bound 
Bound to this group 
Instances 
4 Optional Get 


Binding ARRAY List of all points bound to 
of: this group 


5 Optional Get Status BOOL Status for all discrete 0=OK 
output points in the group | 1 = Product 
specific alarm 
or status 
6 Required Set Command BOOL Changes state of all DOPs | 0=idle 
in group to Idle Mode or | 1=run 
Run Mode 
7 Optional Set Fault Action BOOL State of output after 0=Fault Value 
recoverable failure attribute; 
1=hold last 
state 
8 Optional Set Fault Value BOOL User-defined value for O=off; 
use with Fault State 1=on 
attribute 


9 Optional Idle Action BOOL State of output during idle | O=Idle Value 
attribute; 
1=hold last 
state 


Idle Value BOOL User-defined value for use | 0=off; 
with Idle State attribute 1=on 


5-18.3.1 Command, Fault Action, Fault Value, Idle Action, Idle Value 


a 


5-18.3 Semantics 


When any of these attributes are implemented at the Group level, the corresponding attribute of 
the point objects bound to the group shall assume the value of the Group level object attribute. 
The attribute shall be implemented at the point level and shall be “Get” only. 


The Idle Action and Idle Value behavior shall be the power up default behavior and the 
behavior when in the available state. 
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Discrete Output Group Object, Class Code: 1E Hex 


Common Services 


The Discrete Output Group Object provides the following Common Services: 


Table 5-18.4 Discrete Output Group Object Common Services 


Service Need In Implementation Service Name Description of Service 
Code Class Instance 

OE hex | Conditional * | Required Get_Attribute_Single | Returns the contents of the specified attribute 

10 hex N/A Required Set_Attribute_Single | Modifies an attribute value 

01 hex Optional Optional Get_Attributes_All Returns a predefined listing of this object’s 
attributes (See the Get_Attributes_All_Response 
definition below) 

02 hex N/A Optional Set_Attributes_All Modifies the contents of the attributes of the 
class or object. 


* 
The Get_Attribute_Single service is REQUIRED if any attributes are implemented. 


See Appendix A for definitions of these services. 


Get_Attributes_All Response 


At the Class level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows: 


Table 5-18.5 Get_Attributes All Response Data — Class Level 


OL MINI] DD] Winnie 


Revision (low byte) Default = 
Revision (high byte) Default = 


Max Instance (low byte) Default = 0 


Max Instance (high byte) Default = 0 
Max ID Number of Class Attributes (low byte) Default = 0 


Max ID Number of Class Attributes (high byte) Default = 0 


Max ID Number of Instance Attributes (low byte) Default = 0 


Max ID Number of Instance Attributes (high byte) Default = 0 


Important: Insert default values for all unsupported attributes. 
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At the Instance level, the order of the attributes returned in the “Object/service specific reply 


data” portion of the Get_Attributes_All response is as follows: 


Table 5-18.6 Get_Attributes All Response Data — Instance Level 


Number of Attributes Default = 


1 Attribute List (attribute #1) 
n Attribute List (attribute #m) 
nt+1 Number of Bound Instances Default = 0 


Binding : Instance ID #1 (low byte) 
Binding : Instance ID #1 (high byte) 


Binding : Instance ID #m (low byte) 
Binding : Instance ID #m (high byte) 


Status 

Fault State 

Fault Value 

Idle State 

Idle Value 
Important: Insert default values for all unsupported attributes. 


Important: If the instance attribute * Number of Attributes” is not supported, the default value 
of zero is to be inserted in its place and no members of the ”Attribute List” attribute will 
follow. 


Important: If the instance attribute ” Number of Bound Instances” is not supported, the default 
value of zero is to be inserted into the response byte array and no Binding data will follow. 
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5-18.5 


5-18.6 


Discrete Output Group Object, Class Code: 1E Hex 
Set_Attributes_All Request 


No settable attributes currently exist at the Class level for the Discrete Output Group Object. 


At the Instance level, the order of attributes passed in the “Object/service specific request 
data” portion (see Chapter 4-5.2) is as follows: 


Table 5-18.7 Set_Attributes All Request Data — Instance Level 


Po 
< 
Estes 
| 


Fault State 
Fault Value 
Idle State 
Idle Value 


Important: The Set_Attributes_All service is to be supported only if all settable attributes 
shown above are implemented as settable. 


Object-specific Services 


The Discrete Output Group Object provides no Object—specific services. 


Behavior 
The primary purpose of the Discrete Output Group Object is to bind discrete output points. 


An attribute of the DOG will modify the behavior or report additional status information of all 
DOPs bound to the group. 


The State Transition Diagram below provides a graphical description of the events and 
corresponding state transitions. A subset of the states and events may be supported in an 
application, but the behavior must be consistent. 


The states shown are equivalent to the following: 


Table 5-18.8 Discrete Output Group Object State Definitions 


This state Is equivalent to 
Non-Existent a module without power 


a module that has an unrecoverable fault (e.g. processor 
watchdog timeout) 


a major reconfiguration of the module (e.g. NVS Update) 


Binding when discrete output points are added or bound to the Discrete 
Output Group (executed as part of Power Up cycle) 


Run the point at which Get and Set attribute services can be used to 
access the attributes of the Group Object 
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Table 5-18.9 Discrete Output Group Object State Transition Diagram 


= rigs ay 
(any state) 
| Power Up 


Binding 
Established 


5-18.6.1 Attribute Access Rules 


All attributes are gettable or settable according to their attribute access rules, but only in the 
Run state. 


5-18.6.1.1 Status Attribute 


The Status attribute is simply a logical OR of all possible failure or alarm conditions for all 
points bound to the group. 


Figure 5-18.10 Discrete Output Group Object Status Attribute Operation 


Status 
Failures or Alarms 
for all points 
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5-19.1 


Discrete Group Object, Class Code: 1F Hex 


Discrete Group Object 
Class Code: 1F hex 


The Discrete Group (DG) Object binds other discrete objects including DIP, DOP, DIG or 
DOG. The objects (both input and output) bound to the Discrete Group must support the same 
attributes and services. 


You must establish the list of discrete groups and/or points bound to the Discrete Group at 
power-up, as the Binding List is static and a Get—only attribute of the Discrete Group. 


When to use the Discrete Group Object: 


e when a single attribute is shared among many discrete input and output points 
and/or groups. 


e to more efficiently access data (services that affect all members of the group 
can be supported by the DG). 


Figure 5-19.1 Discrete Group Object Application 


For example: 
The Discrete Group Object could be used when a module contains 4 DIPs and 4 DOPs; the 
DIPs are grouped into a DIG to share a common attribute, and the DOPs are grouped into a 


DOG to share a common output behavior. 


You want all points to share a common status. The DG has the common attribute Status and 
binds the DIG and DOG, which in turn bind the individual points. 


Class Attributes 


Table 5-19.2 Discrete Group Object Class Attributes 


Need in Name Data Type Description of 
Implementation Attribute 


These class attributes are optional and are described in Chapter 4 of this specification. 


Attribute 
ID 


1 thru 7 


Semantics of 
Values 
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5-19.2 Instance Attributes 


Table 5-19.3 Discrete Group Object Instance Attributes 


Attr | Needin | Access Name Data Type| Description of Attribute Semantics of 
ID Impl Rule Values 
1 |Optional | Get Number of USINT Number of attributes 
Attributes supported by the group 
2  |Optional | Get Attribute List ARRAY of | List of attributes supported 
USINT 
3 | Optional | Get Number of USINT Number of points in a group 
Bound Instances 
4 |Optional | Get Binding ARRAY of | List of all instances group 

STRUCT: 


5  |Optional | Get Status BOOL Group is operating without 0=good; 
alarms or faults 1=alarm state 


5-19.3 Common Services 


The Discrete Group Object provides the following Common Services: 


Table 5-19.4 Discrete Group Object Common Services 


Service | Need In Implementation Service Name Description of Service 
Code Class Instance 
OE hex | Conditional * | Required Get_Attribute_Single Returns the contents of the specified attribute 
01 hex Optional Optional Get_Attributes_All Returns a predefined listing of this object’s 
attributes (See the 
Get_Attributes_All_Response definition below) 


* 
The Get_Attribute_Single service is REQUIRED if any attributes are implemented. 


See Appendix A for definitions of these services. 


5-19.3.1 Get_Attributes_All Response 


At the Class level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows: 


Table 5-19.5 Get_Attributes All Response Data — Class Level 
0 Revision (low byte) Default = 1 
Revision (high byte) Default = 0 
Max Instance (low byte) Default = 0 
Max Instance (high byte) Default = 0 
Max ID Number of Class Attributes (low byte) Default = 0 
Max ID Number of Class Attributes (high byte) Default = 0 
Max ID Number of Instance Attributes (low byte) Default = 0 


OL MOINI DI! wInyntr 


Max ID Number of Instance Attributes (high byte) Default = 0 
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Important: Insert default values for all unsupported attributes. 


At the Instance level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows: 


Table 5-19.6 Get_Attributes All Response Data — Instance Level 


Number of Attributes Default = 


1 Attribute List (attribute #1) 
n Attribute List (attribute #m) 
n+1 Number of Bound Instances Default = 0 


Binding : Class ID #1 (low byte) 
Binding : Class ID #1 (high byte) 
Binding : Instance ID #1 (low byte) 
Binding : Instance ID #1 (high byte) 


Binding : Class ID #m (low byte) 
Binding : Class ID #m (high byte) 
Binding : Instance ID #m (low byte) 
Binding : Instance ID #m (high byte) 


p of 8 | eT oe fT oe {8 | 2 [Stata Defeutt = 0 


Important: Insert default values for all unsupported attributes. 
Important: If the instance attribute ” Number of Attributes” is not supported, the default value 
of zero is to be inserted in its place and no members of the ”Attribute List” attribute will 


follow. 


Important: If the instance attribute * Number of Bound Instances” is not supported, the default 
value of zero is to be inserted into the response byte array and no Binding data will follow. 


5-19.4 Object—specific Services 


The Discrete Group Object provides no Object-specific services 
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5-19.5 Behavior 


The primary purpose of the Discrete Group is to bind Discrete Groups and/or Points. 


An attribute of the DG modifies the behavior or reports additional status information of all 
objects bound to the group. 


The State Transition Diagram below illustrates the behavior of a Discrete Group. 


Table 5-19.7 Discrete Group Object State Definitions 


This state Is equivalent to 
a module without power 
Non-Existent a module that has an unrecoverable fault (e.g. processor watchdog timeout) 
a major reconfiguration of the module (e.g. NVS Update) 


Binding when the discrete groups and/or points are added or bound to the Discrete Group 
(executed as part of Power Up cycle) 


Run the point at which Get and Set attribute services can be used to access the attributes of 
the Discrete Group Object 


Figure 5-19.8 State Transition Diagram for Discrete Group Object 


Power Down 


Non-Existent 
(any state) 


Power Up 


Binding 
Established 


5-19.5.1 Attribute Access Rules 


All attributes are gettable or settable according to their attribute access rules, but only in the 
Run state. 


5-19.5.1.1 Status Attribute 


The Status attribute is simply a logical OR of all possible failure or alarm conditions for all 
points bound to the group. 


Figure 5-19.9 Discrete Group Object Status Attribute Function 


Status Failures or Alarms 


for all points 
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Analog Input Group Object 


Class Code: 20 hex 


The Analog Input Group Object (AIG) binds a group of analog input points in a module. All 
points bound to the group share all attributes contained in the group . If an attribute is shared 
(points have the same attributes AND the same attribute values) across more than one Analog 
Input Point (AIP), then that attribute can be contained in an Analog Input Group. An Analog 
Input Point can be bound to more than one Analog Input Group. 


You must establish the list of analog input points bound to the group at power-up, as the 
binding list is static and is a Get—only attribute of the group. 


When to use the Analog Input Group Object: 


e when a single attribute is shared among many input points. 


e to more efficiently access data (services that affect all members of the group can be 
supported by the AIG). 


Figure 5-20.1 Analog Input Group Object Application 


“tN 


Class Attributes 


Table 5-20.2 Analog Input Group Object Class Attributes 
Access 


Need in Name Data Type Description of 
Implementation | Rule Attribute 


These class attributes are optional and are described in Chapter 4 of this specification. 


Attribute 
ID 


1 thru 7 


Semantics of Values 
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5-20.2 Instance Attributes 


Table 5-20.3 Analog Input Group Object Instance Attributes 


Access Name Data Type Description of Attribute Semantics of 
Rule Values 

Get Number of USINT Number of attributes 

Attributes supported by the group 
Get Attribute ARRAY of List of attributes supported 

List U 
Get Number of Bound | USINT Number of points in a 

Instances group 
Get Bound Instances | ARRAY of List of all points bound to 

UINT this group 
Get Status Group is operating without | 0=good; 
alarms or faults 1=alarm state 

Get Owner - Vendor | UINT Vendor ID of group’s 

ID owner 
Get Owner - Serial UDINT 32-bit serial number of 

Number group’s owner 


8 Optional | Set Value Data Type | USINT Determines the data type of | 0 = INT 
AIP’s Value 1= REAL 
2 = USINT 
3 = SINT 
4=DINT 

5 = LINT 

6 = UINT 

7 = UDINT 
8 = ULINT 
9 = LREAL 
100=vendor 
specific 


Attr ID | Need in 
Implem 


1 Optional 


2 Optional 


2 
Z 
4 


3 Optional 


4 Optional 


5 Optional 
6 Optional 


Optional 


9 Reserved 
for CIP 


w 
fe) 
O 
= 


10 Optional | Set Temp Mode BOOL 


5-20.3 Semantics 


Temperature scale to use 0 = Celsius 


when reporting a 1 = Fahrenheit 
temperature value 


N 


5-20.3.1 Value Data Type 


When this attribute is implemented at the Group level, the corresponding attribute of the point 
objects bound to the group shall assume the value of the Group level object attribute. 
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Common Services 


The Analog Input Group Object provides the following Common Services: 


Table 5-20.4 Analog Input Group Object Common Services 


Service Need In Implementation Service Name Description of Service 
Code Class Instance 

OE hex | ¢ nananaal: Required Get_Attribute_Single | Returns the contents of the specified attribute 

10 hex N/A Required 2 Set_Attribute_Single | Modifies an attribute value 

01 hex Optional Optional Get_Attributes_All Returns a predefined listing of this object’s 
attributes (See the 
Get_Attributes_All_Response definition 
below) 

02 hex N/A Optional Set_Attributes_All Modifies the contents of the attributes of the 
class or object. 


y The Get_Attribute_Single service is REQUIRED if any attributes are implemented. 


A The Set_Attribute_Single service is required only if Instance Attributes #8 and/or #10 are implemented. 


See Appendix A for definitions of these services. 


Get_Attributes_All Response 


At the Class level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows: 


Table 5-20.5 Get_Attributes All Response Data — Class Level 


Revision (low byte) Default = 1 


0 


NTO] uaypR] wl] Nyyr 


Revision (high byte) Default = 0 


Max Instance (low byte) Default = 0 


Max Instance (high byte) Default = 0 
Max ID Number of Class Attributes (low byte) Default = 0 
Max ID Number of Class Attributes (high byte) Default = 0 
Max ID Number of Instance Attributes (low byte) Default = 0 


Max ID Number of Instance Attributes (high byte) Default = 0 


Important: Insert default values for all unsupported attributes. 
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At the Instance level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows: 


Table 5-20.6 Get_Attributes All Response Data — Instance Level 


Number of Attributes Default = 


1 Attribute List (attribute #1) 
n Attribute List (attribute #m) 
n+1 Number of Bound Instances Default = 0 


Binding : Instance ID #1 (low byte) 
Binding : Instance ID #1 (high byte) 


Binding : Instance ID #m (low byte) 
Binding : Instance ID #m (high byte) 
Owner Vendor ID (low byte) Default = 0 
Owner Vendor ID (high byte) Default = 0 
Owner Serial Number (low byte) Default = 0 
Owner Serial Number Default = 0 
Owner Serial Number Default = 0 
Owner Serial Number (high byte) Default = 0 
Value Data Type Default = 0 


0 Temp Mode 
Default = 0 
Important: Insert default values for all unsupported attributes. 


Important: If the instance attribute * Number of Attributes” is not supported, the default value 
of zero is to be inserted in its place and no members of the ”Attribute List” attribute will 
follow. 


Important: If the instance attribute ” Number of Bound Instances” is not supported, the default 
value of zero is to be inserted into the response byte array and no Binding data will follow. 


5-20.4.2. Set_Attributes_All Request 


No settable attributes currently exist at the Class level for the Analog Input Group Object. 


At the Instance level, the order of attributes passed in the “Object/service specific request 
data” portion of the Set_Attributes_All request is as follows: 


Table 5-20.7 Set_Attributes_All Request Service Data — Instance Level 


Cae [aes [ae a 


Value Data Type 


Important: The Set_Attributes_All service is to be supported only if all settable attributes 
shown above are implemented as settable. 
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5-20.5 Object—specific Services 


The Analog Input Group Object provides no Object—specific services. 


5-20.6 Behavior 
The primary purpose of the Analog Input Group Object is to bind analog input points. 


An attribute of the AIG modifies the behavior or reports additional status information of all 
AIPs bound to the group. 


The State Transition Diagram below provides a graphical description of the events and 
corresponding state transitions. A subset of the states and events may be supported in an 
application, but the behavior must be consistent. 


The states shown are equivalent to the following: 


Table 5-20.8 Analog Input Group Object State Definitions 


This state Is equivalent to 
Non-Existent a module without power 
a module that has an unrecoverable fault (e.g. processor watchdog timeout) 


a major reconfiguration of the module (e.g. NVS Update) 


Binding when analog input points are added or bound to the Analog Input Group (executed as part of 
Power Up cycle) 

Run the point at which Get and Set attribute services can be used to access the attributes of the 
Group Object 


Figure 5-20.9 State Transition Diagram for Analog Input Group Object 


Non-Existent 


Power Up 


Binding 
Established 


Power Down 
(any state) 
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5-20.6.1.1 


5-20.6.1.2 


5-20.6.1.3 


5-20.6.1.4 
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Attribute Access Rules 


All attributes are gettable or settable according to their attribute access rules. 


Status Attribute 


The Status attribute is simply a logical OR of all possible failure or alarm conditions for all 
points bound to the group. 


Figure 5-20.10 Analog Input Group Object Status Attribute Function 


Status Failures or Alarms 
for all points 


Value Data Type Attribute 


The Value Data Type attribute determines the data type to be used by the attribute Value (and 
perhaps other attributes as well). If Value Data Type is not used, then Value defaults to INT. 
Value (and other attributes) may behave as REAL, USINT, or any other data type based upon 
the definition of Value Data Type, which ultimately provides the ability for the analog point to 
be defined in any length necessary. 


Owner Vendor ID and Owner Serial Number Attributes 


These attributes may be implemented in both the point and group objects. If implemented in 
both, the values shall be the same for the point objects and the group object that binds the point 
object. If a connection to this object is made using the Connection Manager, then the value for 
the Owner Vendor Id and Owner Serial Number shall be the Originator Vendor Id and 
Originator Serial Number contained in the Forward_Open request. These values shall be 
cleared when the connection is closed or deleted. 


Temp Mode Attribute 


The attribute Temp Mode is a Boolean data type that governs the behavior of the Value 
attribute of the AIP when returning a temperature. The temperature is returned in either Celcius 
or Fahrenheit according to the current value of the Temp Mode attribute. AIP values are 
typically returned as a temperature for thermocouple and RTD channels when linearization is 
turned on. 
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Analog Output Group Object 
Class Code: 21 hex 


The Analog Output Group Object (AOG) binds a group of analog output points in a module. 
All points bound to the group share all attributes contained in the group. If an attribute is 
shared (points have the same attributes and the same attribute values) across more than one 
Analog Output Point (AOP), then that attribute can be contained in an Analog Output Group. 
An Analog Output Point can be bound to more than one Analog Output Group. 


You must establish the list of analog output points bound to the group at power-up, as the 
binding list is static and is a Get—only attribute of the group. 


When to use the Analog Output Group Object: 


e when a single attribute is shared among many input points. 


e to more efficiently access data (services that affect all members 
of a group can be supported by the AOG). 


Figure 5-21.1 Analog Output Group Object Application 


rh 
rs 


Class Attributes 


Table 5-21.2 Analog Output Group Object Class Attributes 
Need in Access Name Data Type Description of 
Implementation} Rule Attribute 
Required Get Revision |UINT Revision of this The current value 
object assigned to this 
attribute is two (02) 


These class attributes are optional and are described in Chapter 4 of this specification. 


Number Semantics of Values 
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5-21.2 Instance Attributes 


Table 5-21.3 Analog Output Group Object Instance Attributes 


Attr Need in Access Name Data Description of Attribute Semantics of Values 
ID Implem Rule Type 
1 | Optional Get Num USINT _ | Number of attributes 
Attributes supported by the group 
Optional Get Attribute Array of | List of attributes supported 
List USINT _ | by the group 
Optional Number of |USINT | Number of bindings in the 


Bound group 
Instances 


w 


Bound List of all points bound to 


4 | Required if any 
Analog Output 
Points are not 


Instances this group 


included in the 


Analog Output 
ae 
5 Status BOOL Group is operating without = good; 
alarms or faults = alarm state 
6 Owner - UINT Vendor ID of group’s owner 
Vendor ID 
7 


6 = UINT 
7 = UDINT 
8 = ULINT 


Owner - 32-bit serial number of 
Serial group’s owner 
Number 


8 | Optional Value Data Determines the data type of | Default = 0 = INT 
Type 
100=vendor specific 


any bound Values 0 =INT 
9 | Required Command poe Changes state of AOP to Idle | 0 = idle 
legal eee or Run Mode 1=run 


1= REAL 

10 | Optional Fault USINT _ | Output value to go to on 0 = use Fault 

Action failure or fault 1 = hold last state (default) 

2 = low limit 
3 = high limit 
4-99 = reserved 
100 — 199 = vendor specific 
200 — 255 = reserved 


2 = USINT 
11 | Required if Set Fault Value |INT or | User-defined value for use 
Fault Action is based on | with Fault State attribute 
Implemented attribute 
8 


3 = SINT 
4 = DINT 
5 = LINT 
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Attr Need in Access Name Data Description of Attribute Semantics of Values 
ID Implem Rule Type 


12 | Optional Set Idle Action |USINT | Output value to go to on Idle | 0 = use Idle Value’ 
1 = hold last state (default) 
2 = low limit 
3 = high limit 
4 —99 = reserved 
100 — 199 = vendor specific 
200 — 255 = reserved 


13 | Required if Set Idle Value |INTor | User-defined value for use 
Idle Action is based on | with Idle State attribute 
implemented attribute 

8 


1 All values 0, 1, 2, and 3 shall be supported when the Fault Action or Idle Action attributes are implemented. 
5-21.3. Semantics 


5-21.3.1 Command, Fault Action, Fault Value, Idle Action, Idle Value, Value Data Type 


When any of these attributes are implemented at the Group level, the corresponding attribute of 
the point objects bound to the group shall assume the value of the Group level object attribute. 
The attribute shall be implemented at the point level and shall be “Get” only. 


The Idle Action and Idle Value behavior shall be the power up default behavior and the 
behavior when in the available state. 


5-21.3.2. Value Data Type 


When this attribute is implemented at the Group level, the corresponding attribute of the point 
objects bound to the group shall assume the value of the Group level object attribute. The 
attribute shall be implemented at the point level and shall be “Get” only. 


5-21.4 Common Services 
The Analog Output Group Object provides the following Common Services: 


Table 5-21.4 Analog Output Group Object Common Services 


Service Need In Implementation Service Name Description of Service 
Code Class Instance 
OE hex | Conditional 1 | Required Get_Attribute_Single | Returns the contents of the specified attribute 
10 hex N/A Required 2 Set_Attribute_Single | Modifies an attribute value 
01 hex Optional Optional Get_Attributes_All Returns a predefined listing of this object’s 


attributes (See the 
Get_Attributes_All_ Response definition 
below) 


02 hex N/A Optional Set_Attributes_All Modifies the contents of the attributes of the 
class or object. 


q The Get_Attribute_Single service is REQUIRED if any attributes are implemented. 


A The Set_Attribute_Single service is required only if Instance Attributes #8 and/or #10 are implemented. 


See Appendix A for definitions of these services. 
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5-21.4.1 Get_Attributes_All Response 


At the Class level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows: 


Table 5-21.5 Get_Attributes All Response Data — Class Level 
0 Revision (low byte) Default = 1 
Revision (high byte) Default = 0 
Max Instance (low byte) Default = 0 
Max Instance (high byte) Default = 0 
Max ID Number of Class Attributes (low byte) Default = 0 
Max ID Number of Class Attributes (high byte) Default = 0 
Max ID Number of Instance Attributes (low byte) Default = 3 
Max ID Number of Instance Attributes (high byte) Default = 0 


NYP QO] uy RR] wl] NyyrR 


Important: Insert default values for all unsupported attributes. 


At the Instance level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows: 


Table 5-21.6 Get_Attributes All Response Data — Instance Level 


1 Number of Attributes Default = 0 
2 Attribute List (attribute #1) 
n Attribute List (attribute #m) 
n+1 Number of Bound Instances Default = 0 


Binding : Instance ID #1 (low byte) 
Binding : Instance ID #1 (high byte) 
Binding : Instance ID #m (low byte) 
Binding : Instance ID #m (high byte) 
Owner Vendor ID (low byte) Default = 0 
Owner Vendor ID (high byte) Default = 0 
Owner Serial Number (low byte) Default = 0 
Owner Serial Number Default = 0 
Owner Serial Number Default = 0 
Owner Serial Number (high byte) Default = 0 
Value Data Type Default = 0 
Fault Action, Default = 1 
Fault Value (low byte) Default = 0 


Fault Value (high byte) Default = 0 
Idle Action, Default = 1 
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Cae aes | mee [oa | 


Idle Value (low byte) Default = 0 


Idle Value (high byte) Default = 0 


Important: Insert default values for all unsupported attributes. 


Important: If the instance attribute * Number of Attributes” is not supported, the default value 


of zero is to be inserted in its place and no members of the ”Attribute List” attribute will 
follow. 


Important: If the instance attribute ” Number of Bound Instances” is not supported, the default 


value of zero is to be inserted into the response byte array and no Binding data will follow. 
Set_Attributes_All Request 
No settable attributes currently exist at the Class level for the Analog Output Group Object. 


At the Instance level, the order of attributes passed in the “Object/service specific request 
data” portion of the Set_Attributes_All request is as follows: 


Table 5-21.7 Set_Attributes All Request Service Data — Instance Level 


ee 


Command 


Fault State 


Idle State 


Idle Value (low byte) Default = 0 
Idle Value (high byte) Default = 0 


Important: The Set_Attributes_All service is to be supported only if all settable attributes 
shown above are implemented as settable. 


Object-specific Services 
The Analog Output Group Object provides no Object—specific services. 


Behavior 


The primary purpose of the Analog Output Group is to bind Analog Output Points. 


An attribute of the AOG will modify the behavior or report additional status information of all 


AOPs bound to the group. 
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5-21.6.1.1 


5-21.6.1.2 


Analog Output Group Object, Class Code: 21x 


The State Transition Diagram below provides a graphical description of the events and 
corresponding state transitions. A subset of the states and events may be supported in an 
application, but the behavior must be consistent. 


The states shown are equivalent to the following: 


Table 5-21.8 Analog Output Group Object State Definitions 


This state Is equivalent to 
Non-Existent A module without power 
A module that has an unrecoverable fault (e.g. processor watchdog timeout) 


A major reconfiguration of the module (e.g. NVS Update) 


Binding When analog output points are added or bound to the Analog Output Group (executed as part of 
Power Up cycle) 
Run The point at which Get and Set attribute services can be used to access the attributes of the 


Group Object 


Figure 5-21.9 State Transition Diagram for Analog Output Group Object 


Power Down 
(any state) 


Non-Existent 


Power Up 


Binding 
Established 


Run 


Attribute Access Rules 


All attributes are gettable or settable according to their attribute access rules, but only in the 
Run state. 


Status Attribute 
The Status attribute is simply a logical OR of all possible failure or alarm conditions for all 


points bound to the group. 


Figure 5-21.10 Analog Output Group Object Status Attribute Function 


Status Failures or Alarms 
for all points 


Value Data Type Attribute 


The Value Data Type attribute determines the data type to be used by the attribute Value (and 
perhaps other attributes as well). If Value Data Type is not used, then Value defaults to INT. 
Value (and other attributes) may behave as REAL, USINT, or any other data type based upon 
the definition of Value Data Type, which ultimately provides the ability for the analog point to 
be defined in any length necessary. 
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Owner Vendor ID and Owner Serial Number Attributes 


These attributes may be implemented in both the point and group objects. If implemented in 
both, the values shall be the same for the point objects and the group object that binds the point 
object. If a connection to this object is made using the Connection Manager Object, then the 
value for the Owner Vendor Id and Owner Serial Number shall be the Originator Vendor Id 
and Originator Serial Number contained in the Forward_Open request. These values shall be 
cleared when the connection is closed or deleted. 


Fault Action/Idle Action Values for Analog Output Group and Analog Output 
Point 


Table 5-21.11 Corresponding Attribute Values for Output Group/Analog Output Point Objects 


Value of Analog Output Group Value of Corresponding Analog Output 
Instance Attributes #10 and #12 Point Instance Attributes #9 and #10 
2 
3 2 
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Analog Group Object 


Class Code: 22 hex 


The Analog Group (AG) Object binds other analog objects including AIP, AOP, AIG or AOG. 
The objects (both inputs and outputs) bound to the Analog Group must support the same 
attributes and services. 


You must establish the list of analog groups and/or points bound to the Analog Group at 
power-up, as the Binding List is static and a Get—only attribute of the Analog Group. 


When to use the Analog Group Object: 


e when a single attribute is shared among many analog input and output 
points and/or groups. 

e to more efficiently access data (services that affect all members of 
a group and/or points can be supported by the AG). 


Figure 5-22.1 Analog Group Object Application 


Class Attributes 


Table 5-22.2 Analog Group Object Class Attributes 


Need in Access Name Data Description of 
Implementation | Rule Type Attribute 


These class attributes are optional and are described in Chapter 4 of this specification. 


Semantics of 
Values 


Number 


1 thru 7 
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5-22.2 Instance Attributes 


Table 5-22.3 Analog Group Object Instance Attributes 


Attr | Need in | Access Name Data Type Description of Attribute Semantics of 
ID | Implem | Rule Values 
1 Optional | Get Number of USINT Number of attributes supported by 
Attributes the group 
2 Optional | Get Attribute List ARRAY of | List of attributes supported 
USINT 
3 Optional | Get Number of USINT Number of points in a group 
Bound Instances 
4 Optional | Get Binding ARRAY of | List of all instances in group 
STRUCT: 


Class ID UINT 


5 Optional | Get Status BOOL Group is operating without alarms | 0=good; 
or faults 1=alarm state 
6 Optional | Get Owner - Vendor | UINT Vendor ID of group’s owner 
ID 
7 Optional | Get Owner - Serial UDINT 32-bit serial number of group’s 
Number owner 


8 Optional | Set Value Data Type | BYTE Determines the data type of all 0=INT 
bound object’s Value which 1=REAL 
propagate through another binding | 2 = USINT 
if groups are bound to AG 3 = SINT 

4=DINT 

5 = LINT 

6 = UINT 

7 = UDINT 

8 = ULINT 

9 =LREAL 

100 = vendor 
specific 


5-22.3 Common Services 


The Analog Group Object provides the following Common Services: 


Table 5-22.4 Analog Group Object Common Services 


Service Need In Implementation Service Name Description of Service 
Code Class Instance 
OE hex a 1 | Required Get_Attribute_Single | Returns the contents of the specified attribute 
Conditional 
10 hex N/A Beans 2 Set_Attribute_Single | Modifies an attribute value 
equired 


01 hex Optional Optional Get_Attributes_All Returns a predefined listing of this object’s 
attributes (See the 
Get_Attributes_All_Response definition below) 


: The Get_Attribute_Single service is REQUIRED if any attributes are implemented. 


: The Set_Attribute_Single service is required only if Instance Attributes #8 and/or #10 are implemented. 


See Appendix A for definitions of these services. 
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Get_Attributes_All Response 


At the Class level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows: 


Table 5-22.5 Get_Attributes All Response Data — Class Level 
0 Revision (low byte) Default = 1 
Revision (high byte) Default = 0 
Max Instance (low byte) Default = 0 
Max Instance (high byte) Default = 0 
Max ID Number of Class Attributes (low byte) Default = 0 
Max ID Number of Class Attributes (high byte) Default = 0 
Max ID Number of Instance Attributes (low byte) Default = 0 


NYP QO] Uy RR] wl] NyyrRe 


Max ID Number of Instance Attributes (high byte) Default = 0 


Important: Insert default values for all unsupported attributes. 


At the Instance level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows: 


Table 5-22.6 Get_Attributes_All Response Data — Instance Level 


a“ Bit 7 Bit 6 Bit5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 


Number of Attributes Default = 


; Attribute List (attribute #1 
n Attribute List (attribute #m) 
nt+1 Number of Bound Instances Default = 0 


Binding: Class ID #1 (low byte 
Binding: Class ID #1 (high byte 
Binding: Instance ID #1 (low byte 
Binding: Instance ID #1 (high byte 


Binding: Class ID #m (low byte 
Binding: Class ID #m (high byte 
Binding: Instance ID #m (low byte 
Binding: Instance ID #m (high byte 


Pp of oe fT oe fT oe fT {8 | 8 | Starns Defeuit=0 


Owner Vendor ID (low byte) Default = 0 
Owner Vendor ID (high byte) Default = 0 
Owner Serial Number (low byte) Default = 0 
Owner Serial Number Default = 0 
Owner Serial Number Default = 0 
Owner Serial Number (high byte) Default = 0 
Value Data Type Default = 0 


Important: Insert default values for all unsupported attributes. 
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Analog Group Object, Class Code: 224¢x 


Important: If the instance attribute ” Number of Attributes” is not supported, the default value 
of zero is to be inserted in its place and no members of the ”Attribute List” attribute will 
follow. 


Important: If the instance attribute ” Number of Bound Instances” is not supported, the default 
value of zero is to be inserted into the response byte array and no Binding data will follow. 


Object-specific Services 


The Analog Group Object provides no Object-specific services. 


Behavior 
The primary purpose of the Analog Group Object is to bind analog groups and/or points. 


An attribute of the AG modifies the behavior or reports additional status information of all 
objects bound to the group. 


The State Transition Diagram below provides a graphical description of the events and 
corresponding state transitions. A subset of the states and events may be supported in an 
application, but the behavior must be consistent. 


Except for highly configurable modules (which could have explicit Create and Delete events), 
the states shown in the STD are equivalent to the following: 


Table 5-22.7 Analog Group Object State Definitions 


This state Is equivalent to 
Non-Existent a module without power 
a module that has an unrecoverable fault (e.g. processor watchdog timeout) 


a major reconfiguration of the module (e.g. NVS Update) 


Binding when the analog input and/or output groups and/or points are added or bound to the Analog 
Group (executed as part of Power Up cycle) 

Run the point at which Get and Set attribute services can be used to access the attributes of the 
Analog Group 


Table 5-22.8 Analog Group Object State Transition Diagram 


Non-Existent 


Power Up 


Binding 
Established 


Power Down 
(any state) 
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5-22.5.1.2 


5-22.5.1.3 


Analog Group Object, Class Code: 224¢x 


Attribute Access Rules 


All attributes are gettable or settable according to their attribute access rules, but only in the 
Run state. 


Status Attribute 


The Status attribute is simply a logical OR of all possible failure or alarm conditions for all 
points bound to the group. 


Table 5-22.9 Analog Group Object Status Attribute Function 


Status Failures or Alarms 
for all points 


Value Data Type Attribute 


The Value Data Type attribute determines the data type to be used by all of the bound AIP’s 
Value attribute (and perhaps other attributes as well). If Value Data Type is not used, then 
Value defaults to INT. Value (and other attributes) may behave as REAL, USINT, or any other 
data type based upon the definition of Value Data Type, which ultimately provides the ability 
for the analog point to be defined in any length necessary. 


Owner Vendor ID and Owner Serial Number Attributes 


These attributes may be implemented in both the point and group objects. If implemented in 
both, the values shall be the same for the point objects and the group object that binds the point 
object. If a connection to this object is made using the Connection Manager, then the value for 
the Owner Vendor Id and Owner Serial Number shall be the Originator Vendor Id and 
Originator Serial Number contained in the Forward_Open request. These values shall be 
cleared when the connection is closed or deleted. 
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5-23.1 


5-23.2 


5-23.3 


Attr 


Position Sensor Object, Class Code: 23x 


Position Sensor Object 
Class Code: 23 hex 


The Position Sensor Object models an absolute position sensor in a product. Behaviors in the 
object extend the basic position sensor capability to include zero offset, and position boundary 
checking (CAM switch). 


The Position Sensor Object interface is to real position sensor hardware such as an absolute 
digital encoder, an analog resolver or other absolute position-input device. 


Revision History 


Since the initial release of this object class definition changes have been made that require a 
revision update of this object class. The table below represents the revision history. 


Table 5-23.1 Revision History 


Revision Reason for Change 
01 Initial release of this object class 
02 Add new attributes 


Class Attributes 


Table 5-23.2 Position Sensor Object Class Attributes 
Attr ID Need in Access Name Data Description of Semantics of 
Implementation | Rule Type Attribute Values 
1 Required Get Revision UINT Revision of this The current value 
object assigned to this 
attribute is 02. 


2 thru 7 | These class attributes are optional and are described in Chapter 4 of this specification. 


Instance Attributes 


Table 5-23.3 Position Sensor Object Instance Attributes 


Need in Access | NV Name Data Description of Attribute Semantics of Values 
Implem Rule Type 
Optional Get NV _ | Number of USINT Number of attributes 
Attributes supported in this product 
Optional Get NV | Attribute List | Array of | List of attributes supported 
USINT in this product. 
(icaaien| "| Get Position Value | UDINT Current position. Physical position See 
Unsigned Semantics Section 
hase CAM BOOL Virtual CAM switch value | 0 = Off 
1=On 
Optional Value Bit USINT Position sensor resolution. | See Semantics. 
Resolution 


[Optional | lv | Zero Offset UDINT | Value attribute zero offset | attribute | Value attribute zero offset | offset | See Semantics. 


Optional ee Low UDINT Virtual CAM switch low _ | The default is 0 
Limit limit. 
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NV Data Description of Attribute Semantics of Values 
CAM High UDINT Virtual CAM switch high | The default is 0 
Limit limit. 
Auto Zero BOOL Auto zero control. Rising edge sets Zero 
Offset to Position Value 
Position Value | DINT Current position The content is based upon 
Signed 14, 15, 16, and 17. 
Vv UINT Specifies the device type | See Semantics section 
Type 


Direction BOOL Defines the direction of Default = 0. 
increasing ‘Position Value’ 


Attr Need in Access 
ID Implem Rule 


8 Optional Set 
9 Optional Set 


10 | Conditional’ | Get 


< 


< Z Z Z Z Zz < < 
< < < < 


11 | Optional Get 


12 | Required Set 


Counting 
Toggle 


See semantics section 


BOOL Check encoder at encoder | 0 = OFF 


stand still 1 = ON (Default) 


13 | Optional Set Commissioning 
Diagnostic 


Control 


an 
i 


Optional Set Scaling BOOL 
Function 


Control 


Physical resolution span | 0 = OFF 
(attribute 42) is converted |; —o9N (Default) 
to a numerical value 


ENGUNIT | Format of the position Supported units: 


value of other attributes. | counts(default ) 
millimeter 


micron 

nanometer 

inch 

thousandths inch 

ten thousandths inch 
0x0800-0xOFFF = vendor 
specific 


Position 
Format 


15 | Optional Set 


2 
< 


16 | Optional Set UDINT Number of distinguishable | For rotary devices a span 
steps per one complete equals one revolution. 
span. Less than or equal to 

Physical Resolution Span 


(attribute 42). 


Steps over the total 
measuring range. Only 
used for rotary encoders. 


Measuring 
Units per Span 


Zz 
< 


17 | Optional Set UDINT 


Z 
< 


Position UDINT 
Measuring 


Increment 


18 | Optional Set Specifies the smallest Units depend on Position 
incremental change of the | Format attribute. 
Position Value Signed or | nefault = 1. 

Position Value Unsigned 


attributes 


Preset Value DINT Output position value is See Semantics section 
set to Preset Value. 

COS/delta UDINT Value for position change | See Semantics section 
in COS mode. 


19 | Optional S NV 
20 | Optional S NV 


tad + 


21 | Optional Get Position State | BYTE The state of software limit | Bit 0: 1 = Out of Range 
Register switch. Bit 1: 1 = Range overflow 
Bit 2: 1 = Range 
underflow 
22 | Optional Set NV | Position Low | DINT Low Limit Position See Semantics section 
Limit 
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Attr 
ID 


23 


24 


25 


26 


27 


28 


29 


30 


31 


32 


33 


34 


35 


Need in 
Implem 


Optional 


Optional 


Conditional 


Conditional 


Conditional 


Conditional 


Optional 


Conditional 


Conditional 


Conditional 


Conditional 


Optional 


Conditional 


Z Z 
ae ae 


Position Sensor Object, Class Code: 23x 


Access Name Data 
Rule Type 


NV 


Value for minimum 
acceleration trigger 
threshold. 


Value for maximum 
acceleration trigger 
threshold. 


Minimum DINT 
Acceleration 


Setpoint 


mei 


Maximum DINT 
Acceleration 


Setpoint 


Set NV | Position High |DINT High Limit Position 
When attribute 10 is 
greater than this value, the 
Position State Register, bit 
1 shall be set to one (1). 

Get V_ | Velocity Value | DINT Current speed where the 
format of this value is 
defined in attributes 25 & 
26. 

‘Set NV | Velocity ENGUINT | Format of the velocity 

Format attributes. 
Set NV | Velocity UDINT Specifies the smallest 
Resolution incremental change of the 
Velocity Value attribute 
24. 
Set NV_ | Minimum DINT Value for minimum 
Velocity velocity trigger threshold. 
Setpoint Affects Min. Velocity 
Flag in status Warning 
Attribute 47 
Set NV_ | Maximum DINT Value for maximum 
Velocity velocity trigger threshold. 
Setpoint Affects Max. Velocity 
Flag in status Warning 
Attribute 47 
Get Vv Acceleration DINT Current Acceleration 
Value where the format of this 
value is defined in 
attributes 30 & 31. 
Set NV | Acceleration ENGUINT | Format of the Acceleration 
Format attributes. 
Set NV | Acceleration UDINT Specifies the smallest 
Resolution incremental change of the 
Acceleration Value, 
attribute 29 
: ia 
ARRAY 


G Number of USINT Contains the number of 
CAM Channels independent cams 
Get Vv CAM Channel Contains state of 
State register {of BOOL | independent cam channels 
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See Semantics section 


Default is attribute 15 per 
second 


The meaning of the sign is 
affected by the value of 
attribute 12. See 
Semantics section 


0x1f04 = counts (Steps) 
per second (default) 


See Semantics section 
Units depend on Attr 25 
Default = 1. 


See Semantics section 


Default = 0x80000000. 


See Semantics section 


See Semantics section 
Default = OxXEFFFFFFF. 


See Semantics section 


Default is Velocity Value 
attribute 24 per second? 


Positive value is 
acceleration, negative is 
deceleration. 


See Semantics section 


0x1500 = m/s’ (default) 
See Semantics section 


Default = 1. 


See Semantics section 


Default = 0x8000 0000. 


See Semantics section 


Default = OXEFFF FFFF . 


See Semantics section 


See Semantics section 


Bit0 =CAM_1 
State ... 
Bit x = CAM x+1 
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Attr| Need in Access | NV Name Data Description of Attribute Semantics of Values 
ID Implem Rule Type 


CAM Channel | ARRAY _ | Determines the polarity Bit0 =CAM_1 
Polarity of BOOL | for each Cam Channel 
State Register 


Polarity ... 
Bit x = CAM x+1 


CAM Channel | ARRAY Enables each independent | Bit0 =CAM_ 1 
Enable of BOOL | cam channel where size of Enable ... 
Register array is equal to Number 
of CAM Channels 
attribute. 


Register 


36 | Conditional 
Conditional NV 


Conditional | Set NV | CAM ARRAY 
Low Limit of DINT 
Conditional | Set NV | CAM ARRAY 
High Limit | Of DINT 


40 | Conditional ARRAY 


of UINT 
41 | Optional 


w 
N 


Bit x = CAM x+1 


w 
ee) 


Switch point for the lower 
limit where size of array is 
equal to Number of CAM 
channels attribute. When 
Position Value Signed is 
less than CAM Low Limit 
value, then CAM Channel 
State Register = 1. 


w 
ice) 


Switch point for the higher 
limit where size of array is 
equal to “Number of CAM 
channel” Number of CAM 
channels attribute. 
Position Value Signed is 
greater than CAM High 
Limit value, then CAM 
Channel State Register = 
1. 


This value will be added See Semantics section 
to the CAM High Limit 

and subtracted from the 

CAM Low Limit when 

calculating the cam state. 


Ge Vv Operating BYTE Encoder diagnostic See Semantics Section 
Status operating status 
42 | Optional Ge Physical UDINT Number of distinguishable | For rotary devices, a span 
Resolution 
Span 
e 
position value or require 


steps per one complete equals one revolution. 
span. 
43 | Optional NV _ | Number of 
Optional G V__ | Alarms WORD 
user intervention 
45 |Conditional | Get NV | Supported WORD Information about See Semantics Section 
Alarms supported Alarms 


46 | Conditional V_ | Alarm Fag BOOL Indicates that an alarm See Semantics Section 


error occured. 0=OK 
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a a 
@) 
> 
< 


UINT This is equal to the Default = 1. 
number of turns when a 


rotary type device is used. 


t 
t 
t 
t 
t 
t 


iN 
KR 


Indicates a malfunction See Semantics Section 
has occurred that could 
lead isto an incorrect 


1 = Alarm error 
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Attr 
ID 


47 


48 


49 


50 


51 


5-23.4.1 


5-23.4.2 


5-23.4.3 


Position Sensor Object, Class Code: 23x 


Need in Access | NV Name Data Description of Attribute Semantics of Values 
Implem Rule Type 


Optional Get Vv Warnings WORD Internal parameters See semantics section. 
exceeded 
Conditional | Get NV | Supported WORD Information about See Semantics Section 
Warnings supported Warnings 


Conditional | Get V_ | Warning Flag | BOOL Indicates that a-warning See Semantics Section 
error occured 0=OK 
1 = Warning flag 


Optional Get NV | Operating Stores operating time for 
Time the encoder in tenths of an 
hour 


Conditional | Get NV | Offset Value DINT The Offset value is See Semantics Section 
calculated by the preset 
function. Shift position 
value with the calculated 
value 


1 One and only one of the attributes Position Value Signed or Position Value Unsigned shall be implemented depending 
on the application requirements. 


5-23.4 


Semantics 


Position Value Unsigned - Attribute 3 


This attribute represents the absolute position detected by the position sensor conditioned by 
the Value Bit Resolution and Zero Offset attributes. Refer to the following descriptions of the 
Value Bit Resolution and Zero Offset attributes for details. 


Position Value Signed - Attribute 10 


This attribute represents the absolute position detected by the position sensor. It is not 
conditioned by the Value Bit Resolution and Zero Offset attributes. 


Value Bit Resolution — Attribute 5 


This attribute specifies the number of significant bits used for the Position Value Unsigned 
(attribute 3). The raw value is shifted left or right to supply the indicated number of significant 
bits. 


Table 5-23.4 Bit Resolution Attribute Value 


Resolution Value = 
> Physical Resolution (RawValue << (PhysicalResolution - Bit Resolution)) + ZeroOffset 
< Physical Resolution (RawValue >> (Bit Resolution - PhysicalResolution)) + ZeroOffset 
= Physical Resolution RawValue + ZeroOffset 
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Position Sensor Object, Class Code: 23 px 
Table 5-23.5 Example Bit Resolution Values 


Raw Value Adjusted Val. Notes 


10 bit 0 to FFrex Bit Resolution < Physical Resolution, surplus bits are 
(0 to 3FFhex) discarded 


6 bit 0 to FFhex Bit Resolution > Physical Resolution, missing bits are 
(0 to 3F ex) zero. Adjusted value will actually be 0 to FC;,, in 

a multiples of 4 
10 bit 


10 0 to 3FFhex Bit Resolution = Physical Resolution, no conversion. 
(0 to 3FFyex) 


5-23.4.4 Zero Offset — Attribute 6 


The Zero Offset Attribute adjusts the zero point of Value. Zero Offset is added to Value to 
adjust the zero point. The Zero Offset Attribute is applied after the Value Bit Resolution 
Attribute. 


If the result of the addition exceeds the maximum specified by the Resolution attribute the 
overflow bits are discarded. 


Table 5-23.6 Example Zero Offset Values 


Adjusted Val. Zero Offset Value 


1 Value overflowed 
2 Value underflowed 


5-23.4.4.1 CAM, CAM Low Limit, CAM High Limit — Attributes 4, 7 and 8 


The CAM attribute is a virtual CAM switch. The state of the CAM attribute is determined by 
the CAM Low Limit, CAM High Limit and Position Value Unsigned attributes. The Position 
Value Unsigned attribute is used after the Value Bit Resolution and Zero Offset attributes have 
been applied. 


Table 5-23.7 CAM, CAM Low Limit & CAM High Limit Operation 


CAM Low Limit CAM is On (true, 1) if... CAM is Off (false, 0) if ... 


> CAM High Limit Value > CAM Low or Value < | Value < CAM Low and Value > CAM High 
CAM High 


< CAM High Limit Value > CAM Low and Value Value < CAM Low or Value > CAM High 
< CAM High 
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5-23.4.5 


5-23.4.6 


5-23.4.7 


5-23.4.8 


Position Sensor Object, Class Code: 23pex 
Auto Zero — Attribute 9 


This attribute controls the auto-zero feature of the resolver. A rising edge (transition from 0 to 
1) on this attribute adjusts the Zero Offset attribute to a value that results in the Position Value 
Unsigned attribute being zero. 


If the Zero Offset attribute is implemented as non-volatile, the AutoZero command must store 
the new Zero Offset value. 


Position Sensor Type — Attribute 11 


Table 5-23.8 Attribute 11, Position Sensor Type Values 


Value Definition 
00 Single Turn resolver (value if attribute is not supported) 
01 Single-Turn absolute rotary encoder 
02 Multi-Turn absolute rotary encoder 
03 Single-Turn absolute rotary encoder with electronic turn count 
04 Incremental rotary encoder 
05 Incremental rotary encoder with electronic counting 
06 Incremental linear encoder 
07 Incremental linear encoder with electronic counting 
08 Absolute linear encoder 
09 Absolute linear encoder with cyclic coding 
10 Multi-Sensor encoder interface 
11 Multi-Turn absolute rotary encoder with electronic turn count 
12 Virtual Axis Sensor 
13... 65535 Reserved by CIP 


Direction Counting Toggle — Attribute 12 


For linear devices, the Position Value attribute increases when the value of the Direction 
Counting Toggle attribute is FORWARD/CW (0). If the value of the Direction Counting 
Toggle attribute is REVERSE/CCW (1), the Position Value attribute decreases. The Direction 
Counting Toggle defines the increasing Position Value 1) for rotary devices as clockwise shaft 
rotation or counter clockwise as viewed facing the mounting face (CW = 0, CCW = 1), 2) for 
linear devices as Forward, moving away from the electrical connection, or Reverse, moving 
toward the electrical connection, as viewed from the mounting face. Changing this value shall 
change the sign of velocity and position relative to physical movement. 


For rotary encoders the code sequence defines whether increasing or decreasing position values 
are output when the encoder shaft rotates clockwise (CW) or counterclockwise (CCW) as seen 

on the shaft. Example: By turning the shaft clockwise the Position Value attribute will increase 
when Direction Counting Toggle is defined as clockwise (0O=CW). 


Commissioning Diagnostic Control — Attribute 13 


When the Commissioning Diagnostic Control attribute is set to ON (1) it is possible to check 
the encoder components responsible for position detection at encoder stand still. This enables 
an extensive check of the correctness of the position values. 
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5-23.4.9 


5-23.4.10 


Position Sensor Object, Class Code: 23pex 


If errors are detected, they will be indicated by the respective bits in the Alarm attribute. If this 
attribute is set to OFF (0), no diagnostics will be executed. 


Scaling Function Control — Attribute 14 


When the Scaling Function Control attribute is set to ON (1), the Position Value attribute is 
converted from the physical resolution of the device to position units. 


If this attribute is implemented and turned OFF, all functions within position sensor shall 
continue to use the scaled value, except the Position Value (attribute 10) reported shall be the 
raw, unscaled value. This attribute is provided solely for calibration and troubleshooting 
purposes and does not affect scaling when Position Format (attribute 15) and Measuring Units 
per Span (attribute 16) are implemented. 


The Measuring Units per Revolution and Total Measuring Range in Measuring Units attributes 
are the scaling parameters. 


For rotary devices: 
If Scaling Function Control = = OFF 

Then Position Value = physical resolution of device in counts 
If Scaling Function Control = = ON 


The Position Value = physical resolution of device in counts * (Measuring Units per 
Span (attribute 16) / Physical Resolution Span (attribute 42)) 


If Measuring Units per Span and Total Measuring Range in Measuring Units are not 
supported, the scaling of the Position Value is not provided and the Position Value is always 
equal to physical resolution of the device in counts. 


If Scaling Function Control is not supported, the Position Value shall always be scaled based 
upon the values within Position Format and Measuring Units per Span attributes. When the 
Scaling Function Control attribute is supported and is enabled (ON=1), Position Value is 
calculated according to the formula above. When disabled, physical resolution shall be 
contained in Position Value. 


Position Format — Attribute 15 


This attribute identifies the engineering units for the Position Value attribute (attribute 3 or 10). 
Position Format is a component of all other attributes containing a distance data type, like 
Velocity Value (attribute 24) and Acceleration Value (attribute 29). Engineering units like 
counts, mm or inches are allowed. 


The Position Format (attribute 3 or 10) identifies the engineering units for one increment of the 
Position Value. The Position Measuring Increment (attribute 18) indicates the smallest 
granularity that the Position Value (attribute 3 or 10) shall change. 
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5-23.4.11 


5-23.4.12 


5-23.4.13 


5-23.4.14 


5-23.4.15 


Position Sensor Object, Class Code: 23x 
Measuring Units per Span — Attribute 16 


The Measuring Units per Span sets the number of distinguishable (desired) steps per unit of 
travel. Rotary units would contain the counts per one complete span. 


Total Measuring Range in Measuring Units — Attribute 17 


The parameter Total Measuring Range in Measuring Units sets the number of distinguishable 
steps over the total measuring range. This value must be less than maximum physical resolution 
of the device. Maximum physical resolution should be listed on the type plate. 


This parameter is used for rotary and linear devices.. 


Position measuring increment — Attribute 18 


This attribute may be supported when Position Format (attribute 15) can be set to a value other 
than count (0x1001). The Position Measuring Step attribute defines the measuring step settings 
for the position for linear encoders. Basic position measuring step in 0.001 pm or 0.1nanoinch 
is affected by Position Format (attribute 15). 


Preset Value — Attribute 19 
This attribute supports adapting a desired position value to an actual position value. 
At the instant a “Set Attribute” to attribute #19 is performed, the following occurs: 
Attribute #19 (Preset Value) is set to the service data of the request. 
Offset Value (Attribute #51) is set to the value resulting from [Preset Value] - [Position Value] 
During operation, the formula is immaterial and the behavior of the device is: 

Position Value = (internal position value) + Offset Value 
The value contained in the Preset Value attribute is meaningless (with respect to the indicated 
position) after the Set Attribute has taken effect. The Offset Value remains a constant and the 
now reported Position Value is the adjusted position value using the offset applied to some 


(internal) raw position value. 


The non-settable attribute (from explicit messaging) is actually set (e.g. the Offset Value 
attribute must change) by an internal mechanism. 


Preset Value (attribute 19) = Position Value (attribute 10) + Offset Value (attribute 51). 


COS Delta — Attribute 20 


A COS I/O message will be generated when the Positon Value (attribute 3 or 10) changes by 
this value. Setting this value to 0 disables COS delta limit for Position Value (attribute 3 or 10) 
changes and all position changes shall generate a COS message. 
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5-23.4.16 


5-23.4.17 


5-23.4.18 


5-23.4.19 


5-23.4.20 


Position Sensor Object, Class Code: 23 Hex 
Position State Register, Position limits — Attributes 21 to 23 


The Position Low Limit and Position High Limit attributes configure the actual work area. The 
Position State Register contains the actual area status of the encoder position. If the position is 
out of range, a bit will be set in the Position State Register attribute. If the position is lower 
than the position value set in Position Low Limit, then bit 2 flags the underflow. If the position 
is higher than the position value set in Position High Limit, then bit 1 flags the overflow. The 
Position Limits define a configurable work area within the measuring range. This 
function allows a replacement of external proximity switches. 


Table 5-23.9 Position State Register Structure 


Bit 7 Bit 6 Bit5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 


Reserved | Reserved | Reserved | Reserved | Reserved | Range Range Out of 
underflow | overflow | range 


Velocity Format— Attribute 25 


This Velocity Format attribute identifies the engineering units for the Velocity Value attribute 
(attribute 24). Default is counts (steps) per second. Any reasonable format from Appendix D- 
2.30 may be used depending upon application requirements. Velocity Format is a component of 
all other attributes containing velocity for calculation like acceleration. If this attribute is 
changed, both Minimum Velocity and Maximum Velocity Setpoints shall be reset to their default 
values. This attribute is required when Velocity Value is implemented. Otherwise, this attribute 
is not implemented. 


Velocity Resolution — Attribute 26 


The parameter Velocity Resolution defines the resolution of the Velocity Value attribute. Basic 
velocity resolution is defined in steps of 0.01 mm /s or 0.001 inch/s, affected by the chosen 
Position Format (attribute 15). This attribute is required when Velocity Value is implemented. 
Otherwise, this attribute is not implemented. 


Minimum Velocity / Maximum Velocity - Attribute 27 thru 28 


The actual velocity speed limit values with minimum and maximum can be configured in 
attributes 27 and 28. Corresponding flags in Status Warnings (attribute 68) are affected. These 
attributes are optional when Velocity Value is implemented. 


Acceleration Value - Attribute 29 


Acceleration is defined as the change of velocity (speed) per time unit. The time unit used 
should be seconds. This means the Acceleration Value is given in “Velocity Format” per 
second. The current Acceleration Value is derived from the calculated Velocity Value. The 
value is signed with the following meaning. 


Table 5-23.10 Acceleration Value Attribute 


Value (sign) Explanation 
0 Velocity is constant 
+ Velocity is increasing 
- Velocity is decreasing 


— 5-160 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 3 


5-23.4.21 


5-23.4.22 


5-23.4.23 


5-23.4.24 


Position Sensor Object, Class Code: 23x 
Acceleration Format — Attribute 30 


This attribute identifies the engineering units for the Acceleration Value (attribute 29). Default 
is meters/second. Any reasonable format from Appendix D-2.8 may be used depending upon 
application requirements. If this attribute is changed, both Minimum Acceleration Setpoint and 
Maximum Acceleration Setpoint shall be reset to their default values. This attribute is required 
when Acceleration Value is implemented. Otherwise, this attribute is not implemented. 


Acceleration Resolution — Attribute 31 


The parameter Acceleration Resolution defines the resolution of the Acceleration Value 
attribute. Basic Acceleration Resolution is defined in steps of 1 mm/s? or 0,1 inch/s’, affected 
by the chosen Position Format [attribute15]. This attribute is required when Acceleration Value 
is implemented. Otherwise, this attribute is not implemented. 


Minimum Acceleration /Maximum Acceleration - Attribute 32 thru 33 


The actual acceleration limit values with minimum and maximum can be configured in the 
attributes 32 and 33. Corresponding flags in status Warnings (attribute 47) are affected. These 
attributes are optional when Acceleration Value is implemented. Otherwise, these attributes are 
not implemented. 


Number of CAM Channels — Attribute 34 


This attribute defines the number of cam channels that are supported by an encoder device. 
Each cam has parameters for the minimum switch point, the maximum switch point and setting 
a hysteresis to the switch points. If this attribute is implemented then attributes 35-40 shall be 
implemented. If this attribute is NOT implemented then attributes 35-40 shall NOT be 
implemented. 
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Position Sensor Object, Class Code: 23x 
Figure 5-23.11 Possible Usage of Cam’s and Switch Points 


oe a a 
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CAM Inactive 


Position 
Low Limit High Limit 
CAM Inactive — | fo. 
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Switch Point Active 
Switch Point Inactive | 
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Figure 5-23.12 Possible Usage of Hysteresis 
Hysteresis Hysteresis 


Usage of 
Hysteresis 


Position 


AB CD 
Low limit High limit 


A Low Limit trip occurs at the lower “A” value (dashed left down arrow) and is rest at “B” 
threshold (the higher solid left up arrow). A High Limit trip occurs at the higher “D” value 
(dashed right down arrow) and is reset at the lower “C” threshold (solid right up arrow). 
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Position Sensor Object, Class Code: 23x 
Figure 5-23.13 Principle of CAM Channels 


Channel 1 Channel 2 Channel N 
CAM Channel state register 1 CAM Channel state register 2 CAM Channel state register N 
CAM Channel polarity register 1 CAM Channel polarity register 2 CAM Channel polarity register N 
CAM Channel enable register 1 CAM Channel enable register 2 CAM Channel enable register N 


CAM Channel hysteresis register 1 CAM Channel hysteresis register 2 CAM Ch. hysteresis register N 
Where: N = Number of CAM channels 


5-23.4.25 CAM Channel State Register — Attribute 35 


This attribute defines the status bit of the cam. The status bit set to 1 defines “cam active”. The 
status bit set to 0 defines “cam inactive”. If the CAM Polarity Register attribute of a cam is set 
to one, the actual cam state will be inverted. The CAM Channel State Register array size is 
determined by the value of the Number of CAM Channels attribute 34. 


Table 5-23.14 Cam Channel State register for CAM Channel N 


CAMB CAMA 


N = Number of CAM channel, with respect to Attribute 34 


5-23.4.26 CAM Channel Polarity Register — Attribute 36 


This attribute contains the actual polarity settings for Cam Channel State Register. If the CAM 
Polarity Register bit is set to 1, the cam state of an active cam will signal by setting the related 
cam state bit to zero. In the other case, the cam state of the related cam will not be inverted. 


Table 5-23.15 CAM Polarity Register of CAM Channel N 


CAMB CAM I 


N = Number of CAM channel, with respect to Attribute 34 
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5-23.4.27 


5-23.4.28 


5-23.4.29 


5-23.4.30 


5-23.4.31 


5-23.4.32 


Position Sensor Object, Class Code: 23 px 
CAM Channel Enable Register — Attribute 37 


The Cam Channel Enable Register contains the calculation state for the respective cams. If the 
Cam Channel Enable Register bit is set to 1, the cam state will be calculated by the device. In 
the other case the cam state of the related cam will be set permanently to 0. 


Table 5-23.16 CAM Enable Register of CAM Channel N 


CAMS CAMA] 


N=Number of CAM channel, with respect to Attribute 34 


CAM Low Limit — Attribute 38 


Each cam channel contains the switch point for the lower limit setting for a maximum of 8 
cams for one cam channel. The CAM Low Limit array size is determined by the value of the 
Number of CAM Channels attribute 34. The default value for this attribute is zero. 


CAM High Limit — Attribute 39 


Each cam channel contains the switch point for the higher limit setting for a maximum of 8 
cams for one cam channel. The CAM High Limit array size is determined by the value of the 
Number of CAM Channels attribute 34. The default value for this attribute is zero. 


CAM Hysteresis — Attribute 40 


The CAM Hysteresis value is added to the CAM High Limit and subtracted from the CAM Low 
Limit when calculating the CAM state. The CAM Hysteresis array size is determined by the 
value of the Number of CAM Channels attribute 34. 


Operating Status — Attribute 41 


This attribute contains the operating status of the encoder. 


Table 5-23.17 Operating Status Attribute Bit Definitions 


Bit Description FALSE (0) TRUE (1) 
0 Direction Increasing Decreasing 
1 Scaling Off On 

2..4 Reserved by CIP 

5..7 Vendor specific 


Physical Resolution — Attribute 42 


This is the physical resolution of the position sensor. For rotary devices, the number of steps 
per span can be read out. For linear devices, the units are steps per linear unit (nanometer or 
0.1 nanoinch) the measuring step is given for linear encoder. 
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Position Sensor Object, Class Code: 23x 
5-23.4.33 Number of Spans — Attribute 43 


For a multi-Turn device the Number of Spans and the Physical Resolution (attribute 42) gives 
the physical measuring range to the formula below. 


Physical Measuring range = Physical Resolution * Number of Spans 


5-23.4.34 Alarms — Attribute 44 


An alarm is set if a malfunction bit is set to true (high). The alarm remains active until the 
alarm is cleared and the device is able to provide an accurate position value. 


Table 5-23.18 Alarms Attribute Bit Definitions 


Bit Description FALSE (0) TRUE (1) 
0 Position error NO YES 
1 Diagnostic error NO YES 
2...11 Reserved by CIP 
12...15 Vendor specific 


5-23.4.35 Supported Alarms — Attribute 45 


This attribute contains information on supported alarms by the position sensor device. This 
attribute is required when the Alarms attribute is implemented. 


Table 5-23.19 Supported Alarms Attribute Bit Definitions 


Bit Description FALSE (0) TRUE (1) 

0 Position error Not supported Supported 

1 Diagnostic error Not supported Supported 
2...11 Reserved by CIP 
12...15 Vendor specific 


5-23.4.36 Alarm Flag — Attribute 46 


Indicates that an alarm error has occurred. This attribute is the logical OR of all the alarm bits 
in the Alarms attribute (attribute 44). This attribute is required when the Alarms attribute is 
implemented. 


5-23.4.37 Warnings — Attribute 47 


The Warnings attribute indicates that tolerance for certain internal parameters of the device 
have been exceeded. In contrast to alarms, warnings do not imply incorrect position values. All 
warnings are cleared if the tolerances are again within normal parameters. For the operating 
time limit warning (bit 3) the warning is only set again after a power-on sequence. The 
Warning Flag attribute indicates if any of the defined warnings are active. 
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Table 5-23.20 Warnings Attribute Bit Definitions 


Bit TRUE (1 
Frequency Exceeded YES 

Error 

Reset generated 

YES 

Too low 

Not reached 

Fall below 

Exceeded 

Fall below 

Exceeded 

Exceeded 

11-12 

ae! 


13-15 Vendor specific 


OLD IN [DIMI |WIN ]R|oO 


jet 
Oo 


5-23.4.38 Supported Warnings — Attribute 48 


This attribute contains information on supported warnings by the position sensor device. This 
attribute is required when the Warnings attribute is implemented. 


Table 5-23.21 Supported Warnings Attribute Bit Definitions 


TRUE (1 
Supported 
Supported 
Supported 
Supported 
Supported 
Supported 
Supported 

N 

N 


2 


Supported 
Supported 
Supported 
10 OK Exceeded 
11-12 
13-15 | Vendorspecific | 


5-23.4.39 Warning flag — Attribute 49 


OLD IN ID IMIR [WIN ]R|oO 


Indicates that warning error has occurred. This attribute is the logical OR of all the warnings 
bits in the Warnings attribute (attribute 47). This attribute is required when the Warnings 
attribute is implemented. 


5-23.4.40 Operating Time — Attribute 50 


This attribute is incremented as long as the encoder is powered. The Operating Time value is 
presented in tenths (0.1) of an hour. 


5-23.4.41 Offset Value — Attribute 51 


This attribute is required when the Preset Value (attribute19) is implemented. 
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The Offset Value attribute is calculated by the preset function and shifts the Position Value 
attribute with the calculated value. The Offset Value is stored automatically by the device and 
can be read from the encoder for diagnostic purposes. 


Offset Value (attribute 49) = Preset Value (attribute 19) - Position Value (attribute10). 


5-23.5 Common Services 
The Position Sensor Object provides the following Common Services: 
Table 5-23.22 Position Sensor Object Common Service 
Service Need In Implementation Service Name Description of Service 
Code Class Instance 
0x05 Optional NA Reset Resets all parameter values to the factory default 
0x0D Optional NA Apply_Attributes Cause the configuration to become active 
Ox0E Conditional * | Required Get_Attribute_Single | Returns the contents of the specified attribute 
0x10 N/A Optional Set_Attribute_Single | Modifies an attribute value 
0x15 Optional NA Restore Restores all parameter values from non-volatile 
storage 
0x16 Optional NA Save Saves all parameters to non-volatile storage 
0x18 N/A Conditional Get_Member Returns an element of an array for specified attribute. 
7a Specifically intended for usage on “CAM” attributes. 
0x19 N/A Conditional Set_Member Modifies an element of an array for specified 
a attribute. Specifically intended for usage on “CAM” 
attributes. 


* The Get_Attribute_Single service is required at the class level if any class attributes are implemented 


** The Get_Member and Set_Member services are required when any of the array attributes are implemented. 


See Appendix A for definition of these services 


If several parameters will be modified resulting in side effects the Apply_Attributes service 
shall be implemented to cause the configuration to become active after all parameters have 
been set. The Apply_Attributes service shall validate parameter settings. If any parameters are 
in conflict, the error response Invalid value (0x09) shall be returned with the extended error 
code indicating the conflicting attribute Id. 


If Save or Restore service is implemented, all implemented attributes of the Position 
Sensor Object must be restored or saved to non-volatile storage. 


The reset service has the following parameter: 


Table 5-23.23 Reset Service 


Name Type Description of Request Parameters Semantics of Values 
Type USINT Type of Reset See Table below 


The parameter Type for the Reset service has the following bit specifications: 
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Table 5-23.24 Reset Service Parameter Values 


Value Type of Reset 
0 Emulate as closely as possible cycling power. This value is the default if this parameter is 
omitted. 
1 Return as closely as possible to the out-of-box configuration, then emulate cycling power as 
closely as possible. 


5-23.6 Object—specific Services 


The Position Sensor Object provides no Object—specific services. 


5-23.7. Behavior 
The State Transition Diagram (Figure 5-23.27) provides a graphical description of the events 
and corresponding state transitions. A subset of the states and events may be supported in an 


application, but the behavior must be consistent. 


The State Event Matrix (See Table 5-23.28) lists all pertinent events and the corresponding 
action to be taken while in each state. 


Important: Events can occur simultaneously, but the Fault events have priority if they occur 
simultaneously with other events. 


Figure 5-23.25 State Transition Diagram for Position Sensor Object 
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Important: Events can occur simultaneously, but the Fault events have priority if they occur 
simultaneously with other events. 
The following SEM contains these states: 


e Non-Existent: a module without power. 

e Available: waiting for a connection, power-up discrete input point defaults are set. 
e Run: Position Sensor sensing data from its input and transmitting the data. 

e Recoverable Fault: a recoverable fault has occurred. 

e Unrecoverable Fault: an unrecoverable fault has occurred. 


The SEM also contains these events: 


Table 5-23.26 Position Sensor Object Event Definitions 


This event Is 
Sample Trigger a change of state, cyclic timer trigger, application trigger 
Connection Deleted 1/O connection deleted. 
Apply_Attributes the Apply service of the I/O connection object the Position Sensor Object is connected to. 


Note: the application is responsible for validating the connection object’s attributes. 
Fault Cleared the application clearing a detected fault 


Connection Transitions | I/O connection transitions to Established. 
to Established 


Connection Transitions | I/O connection transitions to Timed-Out 
to Timed Out state 


The figure below is a conceptual illustration of the state machine for a typical input object 
(producing application). The events listed above are represented by the dotted line labeled 
“state change.” 


Figure 5-23.27 Conceptual Position Sensor Object Operation 
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Table 5-23.28 State Event Matrix for the Position Sensor Object 


Event State 


Non-Existent Available Recoverable | Unrecoverable 
Fault Fault 
Sample Trigger | Not Applicable Ignore event Sample data, Ignore event Ignore event 
Send data 
N 


Apply Attributes | Not Applicable Verify attributes, | Return error Return error Ignore event 
return result (Object State (Object State 
Conflict) Conflict) 


Connection Not Applicable Ignore Event Transition to Transition to Ignore event 

Deleted Available Available 

Connection Not Applicable Transition to Ignore event 
Run 


Transitions to 

Established 

Connection Not Applicable Ignore event Transition to Ignore event Ignore event 
Transitions to 


Timed Out state 
Fault Cleared Not Applicable Not Applicable Not Applicable Ignore event 
Run 


Get_Attribute Return Error Return value Return value Return value Return Value 
(Object Does Not Exist) 

Set_Attribute Return Error Accept value Accept value Accept value | Ignore event 
(Object Does Not Exist) 


I/O Status LED Solid Green Flash Red Solid Red 


Reset Not Applicable Perform service | Perform service | Attempt to Ignore Event 
Recover 
Restore Not Applicable Restore from Restore from Ignore Event Ignore Event 
storage storage 


Save Not Applicable Stores parameter | Stores parameter | Ignore Event Ignore Event 


Recoverable 
Fault 


to non-volatile to non-volatile 
memory memory 
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5-24.1 


5-24.2 


5-24.2.1 


Position Controller Supervisor Object, Class Code: 24 yx 


Position Controller Supervisor Object 
Class Code: 24 hex 


The position controller supervisor handles errors for the position controller as well as Home 
and Registration inputs. 


Revision History 


Since the initial release of this object class definition, changes have been made that require a 
revision update of this object class. The table below represents the revision history: 


Table 5-24.1 Position Controller Supervisor Object Revision History 


Revision Description 
01 Initial release 
02 Class Attributes 32 and 33 added 


Class Attributes 


Table 5-24.2 Position Controller Supervisor Object Class Attributes 


Attr Need in | Access Name Data Description of Attribute Semantics of 
ID Implem Rule Type Values 


1 Get Revision UINT _ | Revision of this object. The current value 
Required assigned to this 
attribute is two 
(02). 


These class attributes are either optional or conditional and are described in Chapter 4 of this 
7 specification. 


32 Required Get Consumed USINT | Specifies the axis number to | Value in the range 
Axis which the data contained in | of 1-7 
Selection the I/O Command Message 
Number is routed. 

33 Produced Specifies the axis number to | Value in the range 


Axis which the data contained in | of 1-7 
Consumed Axis Selection Number 


Selection the I/O Response Message 


Number is routed. 


When an I/O Message is consumed by the Position Controller Supervisor object, its internal 
destination may vary. The destination of the I/O Message shall be specified within the 
Command Axis Number. See the description of I/O Connection Messages of the Position 
Controller Device Profile in Chapter 6 for details. 


For static systems, this attribute is normally specified in the Consumed Connection Path of the 
respective I/O Connection instance. 
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5-24.2.2. Produced Axis Selection Number 


When an I/O Message is produced by the Position Controller Supervisor object, its internal 
source may vary. The source of the I/O Message shall be specified within the Response Axis 
Number. See the description of I/O Connection Messages of the Position Controller Device 


Profile in Chapter 6 for details. 


For static systems, this attribute is normally specified in the Produced Connection Path of the 


respective I/O Connection instance. 


5-24.3 Object Instance Attributes 


5-24.3.1 Supervisor Attributes 


Table 5-24.3 Position Controller Supervisor Instance Attributes — Supervisor Attributes 


Description of Attribute Semantics of Values 


The total number of 


Attr 


Need in | Access Name 
ID Implem Rule 
1 Get Number of 
“ 


3 Required 


Data 


E 


USINT 


Attributes 


attributes supported by this 
object in this device 


Attribute List 


Returns an array with a list 
of the attributes supported 
by this object in this device. 


Get Axis Number Returns the axis number 
which is the same as the 
instance for this object. 


General Fault 


i aes 
5 Get BOOL |General Fault flag. This bit 
is logical OR of all fault 
condition attribute flags in 
the device. This bit is reset 
when the fault condition is 


removed. 


Command USINT 


Message Type 


Set Sets the command message 


type that is being sent by 


the controlling device. 


7 Required Set USINT 


Response 
Message Type 


Sets the response message 
that is returned to the 
controlling device 


Fault Input BOOL 
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Return value is in the range 
of 0 to 255. 


Array size defined by 
attribute 1. 


This value will be in the 
range of 1 to 7. 


The axis number is the 
same as the instance 
number for all of the axis 
objects: position controller 
supervisor, position 
controller, drive, motor 
data, and block sequencer. 


1 = fault condition exists. 


Valid Message Type codes 


are 1 to 1F hex. 
1= Type 01 hex 
2= Type 02 hex, etc. 


Valid Message Type codes 
are 1 to 1F hex.. 


1= Type 01 hex 


2= Type 02 hex etc. 


Fault input fault 1 = fault input is active. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 3 
Position Controller Supervisor Object, Class Code: 244. 


Attr Need in | Access Name Data Description of Attribute Semantics of Values 
ID Implem Rule Type 


9 Optional Set Fault Input USINT | Action taken when fault 0 = Command Output 
Action input becomes active code. | Generator Off, 
1 = Hard Stop, 
2 = smooth stop, 
3 = no action. 
4 - 127 = Reserved by CIP 
128 - 255 = Vendor specific 


5-24.3.2. Home and Index Attributes 


Table 5-24.4 Position Controller Supervisor Instance Attributes — Home and Index Attributes 


Access Name Data Description of Semantics of Values 
Rule Type Attribute 


Set Home SINT | Home input action 0 = Command Output 
et 


Attr Need in 
ID Implementation 


10 Optional 


Action code. Action taken Generator off, 
when armed home 


1 = Hard stop, 
input is triggered. 


2 = Smooth stop, 

3 = No action, 

4 = Gate index. 

5 - 127 = Reserved by CIP 
128 - 255 = Vendor specific 


BOOL |Home trigger Active | 0 = active low, 1 = active 
Level flag is used to high. 

program the Home 

inputs active level. 


11 Optional S Home 


Active level 


12 Optional Get/Set |Home Arm |BOOL |Home trigger arm flag | 1 arms the home input, 
is used to arm the reading a 0 indicates the 


Home input. trigger has occurred. 


13 Optional Set Index Action | USINT 


Index input action 0 = Command Output 
code. Generator off, 


1 = Hard stop and, 
2 = Smooth stop, 
3 = No action. 


4 - 127 = Reserved by CIP 
128 - 255 = Vendor specific 


0 = active low, 1 = active 
high. 


14 Optional Get/Set | Index BOOL | Used to program the 


Index inputs active 


Active Level 
level. 


15 Optional Get/Set |Index Arm |BOOL | Index trigger arm flag | 1 arms the index input, 
is used to arm the reading 0 indicates the 


Index input. trigger has occurred. 


Home Input |BOOL | Actual level of the 0 = Home input is low 
Level Home input. 1 = Home input is high. 


Home DINT |Home trigger position | This value can be in the 

Position reflects the position at | range of 0x80000001 to 
the time the home Ox7FFFFFFF. 

input is triggered. 


16 Optional 


Get 
17 Optional Get 
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Attr Need in Access Name Data Description of Semantics of Values 
ID | Implementation | Rule Attribute 


18 Optional Get Index trigger position | This value can be in the 
reflects the position at | range of 0x80000001 to 
the time the home Ox7FFFFFFF. 
input is triggered. 


5-24.3.3 Registration Attributes 


Table 5-24.5 Position Controller Supervisor Instance Attributes — Registration Attributes 


Attr | Needin Access Name Data Type Description of Semantics of Values 
ID Implem Rule Attribute 


19 Optional | Set Registration | USINT Registration input 0 = Command Output 
Action action defines what Generator off 

happens when the 1= Hard Stop 

registration input is a h 

triggered. 2 = Smooth stop 
3 = No action. 
4 = Go to Reg position 
offset 
5 = Go to Reg position 
absolute. 
6 - 127 = Reserved by CIP 
128 - 255 = Vendor specific 


20 Optional Registration |BOOL Registration trigger 0 = active low, 1 = active 
Active level Active Level flag is high. 
used to program the 
Registration inputs 
active level. 
21 Optional | Get/Set Registration |BOOL Registration trigger Set to 1 to arm the 
Arm arm flag is used to arm | registration input, reading a 
the Registration input. | 0 indicates the registration 
trigger has occurred. 


22 Optional | Get Registration |BOOL Actual level of the 0 = registration is low 
Input Level registration input. 1 = registration is high. 


23 Optional | Set Registration |DINT Defines a position This value can be in the 
Offset value that is used as an | range of 0x80000001 to 
offset or absolute Ox7FFFFFFF. 
position dependent on 
the registration action 
code. 
24 Optional | Get Registration |DINT Registration trigger This value can be in the 
Position position reflects the range of 0x80000001 to 
position at the time the | Ox7FFFFFFF. 
Registration input is 
triggered. 
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5-24.3.4 Axis Following Attributes 


Table 5-24.6 Position Controller Supervisor Instance Attributes — Axis Following Attributes 


Attr | Needin | Access Name Data Description of Attribute Semantics of Values 
ID Implem Rule Type 
25 Optional | Set Follow BOOL Follow Enable enables following | 0 = following disabled, 
Enable of the Follow Axis. 1 = following enabled. 
26 Optional | Set Follow USINT _ | Specifies the Axis to follow. 0 = no following, 
Axis 1 to 255 specifies the 
axis. 
27 Optional | Set Follow DINT Used to calculate the Command 
Divisor Position by dividing the Follow 
Axis position with this value. 
28 Optional | Set Follow DINT Used to calculate the Command 
Multiplier Position by multiplying the 
Follow Axis position with this 
value. 


5-24.4 Common Services 


Table 5-24.7 Position Controller Supervisor Common Services 


Need in 


Name Service Description of Service 
Implementation Code 


Required Get_Attribute_Single Returns the contents of the specified attribute 
Required Set_Attribute_Single Modifies the attribute value. 


See Appendix A for definitions of these services 


5-24.5 Object-specific Services 
The Position Controller Supervisor object provides no object-specific services. 


5-24.6 Behavior 


Object behavior is defined by the following state diagrams. 
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5-24.6.1 Position Controller Supervisor State Diagrams 


5-24.6.1.1 Home Input State Diagrams 


The following state diagram describes the behavior of the Home input. The Home input active 
level can be programmed. Home will trigger when it is armed and the input goes to the active 

level. When home is triggered the home action is performed and the home input returns to the 
disabled state. 


Figure 5-24.8 Home Input State Diagram 
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5-24.6.1.2 Index Input State Diagram 


The following diagram describes the behavior of the Index input. The Index input active level 
can be programmed. Index will trigger when it is armed and the input goes to the active level. 

In addition the index input can be gated using the Home input when the Home Action attribute 
is set to Gate index. When index is triggered the index action is performed and the Index input 
returns to the disabled state. 


Figure 5-24.9 Index Input State Diagram 
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5-24.6.1.3 Registration Input State Diagram 


The following state diagram describes the behavior of the Registration input. The Registration 
input active level can be programmed. The Registration input will trigger when it is armed and 
the input goes to the active level. When the Registration input is triggered the Registration 
action is performed and the Registration input returns to the disabled state. 


Figure 5-24.10 Registration Input State Diagram 
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5-25 


5-25.1 


5-25.2 


Position Controller Object, Class Code: 25x 


Position Controller Object 
Class Code: 25 hex 


The position controller object performs the control output velocity profiling and handles input 
and output to and from the motor drive unit, limit switches registration etc. 


Revision History 


Since the initial release of this object class definition, changes have been made that require a 
revision update of this object class. The table below represents the revision history: 


Table 5-25.1 Position Controller Object Revision History 


Revision Description 
01 Initial release 
02 Instance Attribute 58 added 


Class Attributes 
Table 5-25.2 Position Controller Object Class Attributes 
Need in | Access Name Data Description of 
Implem | Rule Type Attribute 
Required |Get Revision |UINT Revision of this 
object. 


These class attributes are either optional or conditional and are described in Chapter 4 of this 
specification. 


Number Semantics of Values 


The current value assigned to this 
attribute is two (02). 


2 thru 7 
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5-25.3 Instance Attributes 


Table 5-25.3 Position Controller Object Instance Attributes 


Attr | Needin | Access Name Data Description of Attribute Semantics of Values 
ID Implem | Rule 


Number of 
Attributes 


USINT _ | Returns the total number of Return value is in the range 
attributes supported by this of 0 to 255. 


object in this device. 


S 4 

Z Z 
4 4 3 
oO 


| . 
2 Required | Get Attribute 
List 


3 Optional | Set Mode USINT 


Array of | Returns an array witha list of | Array size defined by 
USINT _ | the attributes supported by this | attribute 1. 


object in this device. 


Operating mode. 0 = Position mode(default), 
1 = Velocity mode, 


2 = Torque mode. 


4 Optional | Set DINT Position Units ratio value is the | Set this value to a positive 
number of actual position number only. Default = 1. 
feedback counts equal to one 


position unit. 


Profile Units ratio value is the | This value is set to a 
number of actual position positive number only. 
feedback counts per second or _ | Default = 1. 

second’ equal to one velocity, 

acceleration or deceleration 

unit.. 


5 Optional | Set Profile Units | DINT 


6 Required | Set Profile move position defined | This value can be in the 


in position Units range of 0x80000001 to 
Ox7FFFFFFF. 
f Required | Set Target DINT Profile velocity defined in This value is set toa 
Velocity profile units per second. positive number only. 
8 Required | Set Acceleration | DI Profile Acceleration rate This value is set toa 
defined in profile units per positive number only. 
second’, 


g 
Z 
4 


9 Optional | Set Deceleration Profile Deceleration rate This value is set toa 
defined in profile units per positive number only. 
second’, 


10 Optional | Set Incremental | BOOL Incremental Position Flag If set to 0 the target position 
Position (attribute 6) will be 
Flag interpreted as absolute. If 
set to 1 the target position 
will be interpreted as 
incremental 
11 Required | Set Load Data/ |BOOL Used to Load Command Data, | See “Semantics” at end of 
Profile Start a Profile Move, and this table. 
Handshake 
12 Get 


indicate that a Profile Move is 
in progress. 


BOOL On target position flag Reads Set when the Target 
indicates that the motor is position equals the actual 
within the deadband (Attribute | position within deadband 
38) distance to the target limits. Will clear if target 


position. position is changed. 
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Attr | Needin | Access Name Data Description of Attribute 
ID Implem | Rule Type 


Actual Absolute position value 
equals the real position in 


DINT 


Actual 
Position 


position units. Set to re-define 
Actual Position 


: 


14 Optional | Get Actual DINT Actual Velocity in profile 
Velocity units/sec. 
15 Optional | Get Commanded | DINT This value equals the 
Position instantaneous calculated 
position. 

16 Optional | Get Commanded | DINT This value equals the 

Velocity Instantaneous calculated 
velocity in profile units per 
second. 

17 {Optional | Set BOOL — | Enable Output. 

18 Optional | Set Profile Type |USINT | Profile Type code defines the 
type of move profile. 

19 Optional | Set Profile Gain | DINT This attribute provides a gain 
value for non-trapezoidal 
profiles such as S-Curve 
profiling. The implementation 
and function of this gain is 
vendor specific. 

20 Set Smooth Stop | BOOL Smooth stop motor. 

21 Set Hard Stop BOOL Hard stop motor. 

22 Optional | Set Jog Velocity | DINT Defines the jogging velocity in 
profile units per second. 

23 Direction BOOL Instantaneous direction 

24 Optional | Set Reference BOOL Defines direction. 

Direction 
25 Optional | Set Torque DINT Output torque. 
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Semantics of Values 


When set this value can be 
in the range of 0x80000001 
to Ox7FFFFFFF. 


Value read will be positive. 


When read this value will 
be in the range of 
0x80000001 to 
Ox7FFFFFFF. 


Value read will be positive. 


Set to enable drive and 
feedback, clear to disable. 


0 = Trapazoidal, 

1 = S-Curve, 

2 = Parabolic. 

3 - 127 = Reserved by CIP 
128 - 255 = Vendor specific 


Range is defined by the 
vendor. 


Set to force immediate 
deceleration to zero 
velocity at programmed 
decel rate. 


Set to force immediate 
deceleration to zero 
velocity at max decel rate. 


This value is set toa 
positive number only. 


0 = negative or reverse 
direction and 1 = positive or 
forward. This value can be 
set in Velocity mode to 
change direction. 


0 = forward direction is 
clockwise, 


1 = reverse direction is 
counter clockwise as 
viewed from the load end of 
the motor shaft. 


Set this value to change the 
torque (Torque mode only) 

or read the current torque. 0 
= no torque output. Range 

defined by the vendor. 
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Attr | Needin | Access Name Data Description of Attribute Semantics of Values 
ID Implem | Rule Type 
26 Optional | Set Positive DINT This value sets the maximum __| This value is set to a 
Torque allowable torque output in the | positive number only. 
Limit positive direction. Range defined by the 
vendor. 
27 DINT This value sets the maximum This value is set toa 


allowable torque output inthe | negative number only. 
a a 


negative direction. Range defined by the 
29 Optional | Get Wrap BOOL Position Wrap Around If set to 1 the motor has 
Around indicator Flag gone past its maximum 

position. This can only 
happen in Velocity mode 
and is not necessarily a 
fault condition. This bit is 
reset when read. 


vendor. 
30 Proportional gain. Range is 0 to 32767. 
31 Integral gain. Range is 0 to 32767. 


34 Optional | Set KiMode USINT _ | Integration limit Mode. 0 = use Ki term at all times, 
1 = use Ki term only when 
stopped and holding 
position. 

35 Optional | Set INT Velocity feed forward gain Range is 0 to 32767. 


value. 


36 Optional | Set Accel Feed | INT Acceleration feed forward gain | Range is 0 to 32767. 
Forward value. 


37 Optional | Get Sample Rate | INT Update sample rate in Value returned is positive. 
uSeconds. 


38 Optional | Set Position USINT _ | Set this value to prevent axis Range is 0 to 255. 
Deadband hunting within the desired 
window. 


39 Optional | Set Feedback 
Enable 


BOOL This flag will set or clear 0 = command output 
automatically with the Enable | generator off, 
attribute (17). Feedback can be 
tured off, using this attribute, 
leaving the enable on, for offset 


adjustments on the drive unit 


1 = command output 
generator on. 


DINT Feedback resolution in counts. | This value is set to a 
Number of actual position positive number only. 
feedback counts in one 

revolution of the position 


feedback device. 


40 Optional | Set Feedback 
Resolution 


DINT Motor resolution in motor This value is set to a 
steps. Number of motor steps in | positive number only. 


one revolution of the motor. 


41 Optional | Set Motor 
Resolution 
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Attr | Needin | Access Name Data Description of Attribute Semantics of Values 
ID Implem | Rule Type 


42 Optional | Set Position DINT Position Tracking Gain Range defined by the 
Tracking (Stepper) Gain value for vendor. 

Gain position maintenance to control 

steppers with position 

feedback. 


Position maintenance value to | This value is set to a 
prevent stepper motor stalls. positive number only. 
Value in counts per second. 


43 Optional | Set Max 
Correction 
velocity 


UINT 


44 Optional | Set Max Static |DINT 
Following 


Error 


Maximum allowable following | Set to value to a positive 
error when the motor is stopped | number only. 

and holding position. If the 

difference between actual and 

commanded position exceeds 

this value, following error flag 

is set. 


45 Optional | Set DINT Maximum allowable following | Set to value to a positive 
error when the motor is in number only. 

motion. If difference between 

actual and commanded position 

exceeds this value, following 


error flag is set. 


46 Optional | Set Following USINT 


Error Action 


Following error action code. 0 = Command Output 
Generator Off, 


1 = Hard Stop, 

2 = Smooth stop 

3 = no action. 

4 - 127 = Reserved by CIP 
128 - 255 = Vendor specific 


Following error occurrence Set when a following error 
flag. Set when a following error | occurs. This bit can be 
occurs. This bit is reset when _| cleared directly or by re- 
another move is attempted. programming the Following 
Error Action attribute. 


47 Optional | Set Following BOOL 


Error Fault 


48 Optional | Get DINT Actual Following Error. This value is the actual 


amount of Following Error 
in position feedback counts. 


49 Optional | Set Hard Limit |USINT | Hard limit action code. 0 = Command Output 
Action Generator Off 
1 = Hard Stop 


2 = smooth stop. 
3 - 127 = Reserved by CIP 
128 - 255 = Vendor specific 


Get Forward BOOL Motion is not allowed in the Set when the forward limit 
Limit positive direction when active. | stop is active. 

Get Reverse BOOL Motion is not allowed in the Set when a reverse limit 
Limit negative direction when active. | stop is active. 


BOOL 


50 Optional 


51 Optional 


52 Optional | Set Soft Limit 
Enable 


Enables soft limits When set, motion that 
exceeds the defined limits 
will result in a motor stop. 
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Attr | Needin | Access Name Data Description of Attribute Semantics of Values 
ID Implem | Rule Type 


53 


54 


55 


56 


57 


58 


Soft Limit USINT | Soft limit action code. 0 = Command Output 
Action Generator Off, 


1 = Hard Stop, 


2 = smooth stop. Action 
codes 128 through 255 are 
for vendor specific action. 


Optional Positive Soft | DINT Soft limit positive boundary This value can be in the 
Limit defined in position units.. range of 0x80000001 to 
Position Ox7FFFFFFF. 
Optional Negative Soft limit negative boundary This value can be in the 
Soft Limit defined in position units.. range of 0x80000001 to 
Position Ox7FFFFFFF. 
ica ak 
Optional 
Limit flag. stop occurs. 
Triggered 


Required |G Load Data Indicates that valid data for a See “Semantics” at the end 
Complete valid I/O command message of this table. 
type has been loaded into the 
position controller device. 


Positive Hard Forward limit occurrence | Set when a positive limit 
Limit flag. stop occurs. 
Triggered 


Negative Hard Reverse limit occurrence | Set when a negative limit 


Set 
Set 
Set 
Get 
Get 
et 


5-25.3.1 Semantics 


5-25.3.1.1 


Profile in Progress 


This attribute performs three functions: 


loading data in the I/O command message; 
starting a Profile Move in the both the i/o command message and explicit messaging; and 


indicating if a Profile Move is in process. See the chart below for a complete explanation of 
the device's behavior with respect to this bit. 
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5-25.3.1.2 


5-25.4 


5-25.5 


5-25.6 


Position Controller Object, Class Code: 25x 
Table 5-25.4 Behavior of Device With Respect to Profile In Progress Attribute 


Connection Message Bit Name Behavior 
Type or 
Service 
10) Command Load Data/ When this bit transitions from zero to one, the position 
Start Profile controller device will attempt to load the data contained in the 


command message data bytes. If the command message type 
contained in the command message is the command message 
type that starts a Profile Move, the Profile Move will start. See 
the table in Section 6-18.4.3 for an explanation of which 
command message type starts a Profile Move for each mode. 


Response Profile in This bit will indicate that a Profile Move is in progress. This 
Progress bit will read 1 when a Profile Move is started and will remain 1 
until the Profile Move is complete or terminated, at which point 
it will be zero. 


Explicit Set_Attribute Start Profile A "Set_Attribute_Single" service, which sets this attribute to 1 
_Single will start a Profile Move. A "Set_Attribute_Single" service, 
which sets this attribute to 0 will have no effect. 
Get_Attribute | Profile in This bit will indicate that a Profile Move is in progress. This 
_Single Progress bit will be one after receipt of a set attribute service which sets 


this attribute to 1 and will remain 1 until the profile move is 
complete or terminated, at which point it will be zero. 


Load Data Complete 


This bit is used for data handshaking in the I/O message. It reflects that the position controller 
device has successfully loaded the data contained in the I/O command message data bytes. 
This attribute will be reset when the Load Command Data/Start Profile bit is reset. Refer to 
the Position Controller Device Profile in Chapter 6 for an explanation of the handshaking 
procedure. This bit is not affected by explicit messaging. 


Common Services 


Table 5-25.5 Position Controller Object Common Services 


Need in Name Service Description of Service 
Implementation Code 


Required Get_Attribute_Single Returns the contents of the specified attribute 
Required Set_Attribute_Single Modifies the attribute value. 


See Appendix A for definition of these services 


Object-specific Services 
The Position Controller object provides no object-specific services. 
Behavior 


Object behavior is defined by the following state diagrams 
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5-25.6.1 
5-25.6.1.1 


Position Controller Object, Class Code: 25x 


Position Controller State Diagrams 


Profile Move Generation State Diagrams 


The state diagram below describes Position Controller profile generation. The Profile 
generator uses Acceleration, Target, Velocity and Deceleration to perform a profile move to the 
Target Position. In profile velocity mode the Target Position is infinite with polarity defined 
by the direction attribute until such time the device is commanded to decelerate and stop. 


After the profile position is generated, it passes through a limit filter. If the generated Profile 
position is outside the defined software limits, or if a hardware limit is active, the profile is 
modified and the output Command position is limited. The limit function and attributes are 
optional. 


The Command Position is then sent to the output generator, which produces a control signal. 
The output generator can be servo, stepper or some other method for controlling position. 
Commanded Acceleration and Velocity are also sent to the output generator for feed forward 
purposes. Feedback is optional unless required by the output method being used. 


Figure 5-25.6 Position Controller Profile Generation State Diagram 
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Position Controller Object, Class Code: 25x 
5-25.6.1.2 Servo Output Generation State Diagram 


The diagram below is an example of a Servo Command output generator. Commanded 
Position, Velocity and Acceleration input comes from the Profile Generation diagram. 


Figure 5-25.7 Servo Output Generator State Diagram 
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5-25.6.1.3 Torque Mode Output State Diagram 


The following diagram describes the direct torque mode function. 


Figure 5-25.8 Torque Mode State Diagram 


-—C_ Positive Torque Limit » 
Torque 
Generator 
-—_C_ Negative Torque Limit » 


Torque Out 


— 5-188 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 3 


Block Sequencer Object, Class Code: 26x 


5-26 Block Sequencer Object 
Class Code: 26 hex 


This object handles the execution of Command Blocks or Command Block chains. 


5-26.1 Class Attributes 


Table 5-26.1 Block Sequencer Object Class Attributes 


Need in Access Name Data Type Description of 
Implementation | Rule Attribute 


1 thru 7 | These class attributes are optional and are described in Chapter 4 of this specification. 


Semantics of 
Values 


5-26.2 Instance Attributes 
These attributes can be used for control, configuration or status. 


Table 5-26.2 Block Sequencer Object Instance Attributes 
Attr| Needin | Access Name | Data Type Description of Semantics of Values 
ID | Implem Rule Attribute 
1 Required |Set/Get | Block USINT Instance number of | This value Defines the Command 
starting Command _ | Block instance to execute. Set from 
Block. 1 to 255. 
2 Required |Get/Set | Block BOOL Block execution Setting this value executes the block 
Execute flag. defined by the Block Attribute (1). 
When this value reads back cleared, 
the block or chain of blocks is done. 


3 Required |Get Current USINT Current block in This value contains the Command 
Block execution. Block instance number of the 
currently executing block (1 - 255). 
4 Required |Get Block BOOL Block fault flag. Set when a block error occurs, such 
Fault as the Wait Equals command time- 
out or execution of an invalid 
Command Block. when a Block 
Fault occurs block execution will 
stop. This bit is reset when the 
Block Fault Code attribute (5) is 
read. 
Get 
Set 


5 Optional Block fault Code. Defines the specific block fault. 
0 = no fault, 
1 = invalid or empty block data, 


2 = command time-out (Wait 
Equals) , 


3 = execution fault. 


6 Optional Counter |DINT Sequencing Must be positive. Counter that can 
Counter. be used for sequencing loops. 
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5-26.3 


5-26.4 


5-26.5 


5-26.5.1 


Block Sequencer Object, Class Code: 26x 


Common Services 


Table 5-26.3 Block Sequencer Object Common Services 


Need in Name Service Description of Service 
Implementation Code 


Required Get_Attribute_Single Returns the contents of the specified attribute 
Required Set_Attribute_Single Modifies the attribute value. 


See Appendix A for a description of these services 


Object-specific Services 

The Block Sequencer object provides no object-specific services. 
Behavior 

Object behavior is defined by the following state diagrams 


Block Sequencer State Diagrams 


The diagram below describes the Block Sequencer. When the Sequencer is commanded to 
execute a block, the Block Execution state is entered. Block execution continues on 
consecutive blocks until the end of the linked chain is reached or an error occurs. 


Figure 5-26.4 Block Sequencer State Diagram 
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5-27.1 


5-27.2 


Command Block Object, Class Code: 27x 


Command Block Object 
Class Code: 27 hex 


Each instance of the Command Block object defines a specific command. These blocks can be 
linked to other blocks to form a command block chain. 


Class Attributes 


Table 5-27.1 Command Block Object Class Attributes 


Need in Access Name Data Type Description of 
Implementation | Rule Attribute 


1 thru 7 | These class attributes are optional and are described in Chapter 4 of this specification. 


Number Semantics of Values 


Attributes 


These attributes are downloaded at configuration time and executed at run time through the 
Block Sequencer object. Attributes 3, 4, and 5 definitions are dependent on the block 
command attribute (01). Each instance of the Block command class defines a different block 
command that can be linked to any other block command instance to form an execution 
sequence. 


Table 5-27.2 Command Block Object Instance Attributes 


Attr Need in Access Description of Semantics of Values 
ID | Implementation | Rule Attribute 


1 Required Block USINT Block Command | Defines the format of the 
Command block data. Command data 
formats are defined below. 
2 Required Block Link # | USINT Block link This value provides a link to 
instance number. | the next block instance to 
execute. When this block is 
done, the link block will be 
executed. 
3 Depends on Depends on _ | Depends on Refer to the command 
Command Command Command definitions for the description 
of attribute 3. 
4 Depends on Depends on _ | Depends on Refer to the command 
Command Command Command definitions for the description 
of attribute 4. 
5 Depends on Depends on _ | Depends on Refer to the command 
Command Command Command definitions for the description 
of attribute 5. 
6 Depends on Depends on _ | Depends on Refer to the command 
Command Command Command definitions for the description 
of attribute 6. 
7 Depends on Depends on _ | Depends on Refer to the command 
Command Command Command definitions for the description 
of attribute 6. 
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5-27.3.1 


5-27.3.2 


Command Block Object, Class Code: 27 4x 


Command Specific Attribute Services 


This section defines the Command block data. Command blocks can be linked together to 
form a command block chain. Looping and branching commands are supported. 


Modify Attribute Command - 01 


This command is used to change an attribute’s value. Attribute 1 must be set to 01. 


Table 5-27.3 Command Block - Modify Attribute Command 
Attr Need in Access Name Data Type Description of Semantics of Values 
ID | Implementation | Rule Attribute 
3 Required for Set Target USINT Target class number | This value Defines the 
Command 01 Class to perform block class which will be 
sequencing on. sequenced. 
4 Required for Set Target USINT Target instance This value Defines the 
Command 01 Instance number of the class | instance of the class which 
to perform block will be sequenced. 
sequencing on. 


5 Required for Attribute # | USINT Position Controller | Position Controller class 
Command 01 Attribute attribute number. Must be 
a settable attribute. 
Attribute ependent on | Attribute Data. The new Attribute data. 
Data attribute # 


Wait Equals Command - 02 


6 Required for 
Command 01 


This command is used to stop execution of a linked chain of command until an attribute 
becomes valid. Attribute 1 must be set to 02. 


Table 5-27.4 Command Block — Wait Equals Command 

Need in Access Name Data Type Description of Semantics of Values 
Implementation | Rule Attribute 

Target U 

Class 

Target U Target instance number | This value Defines the 

Instance of the class to perform | instance of the class which 

block sequencing on. will be sequenced. 


SINT 

SINT 

SINT 
DINT 


Required for 
Command 02 
sequencing on. 


Required for 
Command 02 


Required for Attribute # 
Command 02 


settable attribute. 


Target class number to | This value Defines the class 
perform block which will be sequenced. 


Position Controller Position Controller class 
Attribute attribute number. Must be a 


Required for Set Compare Compare Time-out Set from 0 to 7FFFFFFF 
Command 02 Time-Out value in milliseconds. | hex. If compare does not 
value happen within time-out a 
fault is generated and 
motion stops. 0 = no time- 
out. 
Required for Set Compare Dependent {Compare data for end of | If the attribute listed above 
Command 02 Data on attribute # | command. is Becomes equal to the 
compare data the block is 
done and the next link 
block is executed. 
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Command Block Object, Class Code: 274ex 
Conditional Link Greater Than Command - 03 


This command is used for conditional linking or branching in a linked chain of commands. 
Attribute 1 must be set to 03. 


Table 5-27.5 Command Block — Conditional Link Greater Than Command 


Attr Need in Access Name Data Type | Description of Semantics of Values 
ID _ | Implementation | Rule Attribute 
3 Required for Set Target USINT Target class This value Defines the class 
Command 03 Class number to which will be sequenced. 
perform block 
sequencing on. 
4 Required for Target USINT Target instance | This value Defines the 
Command 03 Instance number of the instance of the class which 
class to perform | will be sequenced. 
block 
sequencing on. 


5 Required for Attribute # | USINT Position Position Controller class 
Command 03 Controller attribute number. Must be a 
Attribute settable attribute. 


6 Required for Compare USINT Conditional Alternate Link block if 
Command 03 Link # Link Number. attribute is greater than 
compare data. 
7 Required for Compare Dependent on | Compare data If the attribute listed above is 
Command 03 Data attribute # for conditional | greater than the compare 
link. data the normal link attribute 
(02) is ignored and the next 
block executed is the 
compare link block. 
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5-27.3.5 


5-27.3.6 


Command Block Object, Class Code: 27 4x 
Conditional Link Less Than Command - 04 


This command is used for conditional linking or branching in a linked chain of commands. 
Attribute 1 must be set to 04. 


Table 5-27.6 Command Block — Conditional Link Less Than Command 


Attr Need in Access Name Data Type Description of Semantics of Values 
ID | Implementation | Rule Attribute 


3 Required for Target Class USINT Target class This value Defines the 
Command 04 number to perform | class which will be 
block sequencing | sequenced. 
on. 
4 Required for Target Instance | USINT Target instance This value Defines the 
Command 04 number of the class | instance of the class which 
to perform block | will be sequenced. 


sequencing on. 


Set 
Set 
5 Required for Set Attribute # USINT Position Controller | Position Controller class 
Command 04 Attribute attribute number. Must be 
a settable attribute. 
6 Required for Set Compare Link # | USINT Conditional Link |} Alternate Link block if 
Command 04 Number. attribute is less than 
compare data. 
Set 


7 Required for Compare Data |Dependent {Compare data for | If the attribute listed above 

Command 04 on attribute # | conditional link. is less than the compare 
data the normal link 
attribute (02) is ignored 
and the next block 
executed is the compare 
link block. 


Decrement Counter Command - 05 


This command is used to decrement the Block Sequencers counter attribute used for looping. 
Attribute 1 must be set to 05. 


Table 5-27.7 Command Block — Decrement Counter Command 


Attr ID Need in Access Name Data Type | Description of Semantics of Values 
Implementation | Rule Attribute 


No additional attributes required for this command 


Delay Command - 06 


This command is used to perform a delay in a linked chain of commands. Attribute 1 must be 
set to 06. 


Table 5-27.8 Command Block — Delay Command 


Attr ID Need in Access Name Data Type | Description of Semantics of Values 
Implementation | Rule Attribute 
3 Required for Delay in Set the delay in 


Command 06 Milliseconds milliseconds 1 hex to 
7FFFFFFF hex 
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5-27.3.7. Trajectory Command - 07 


This command is used to initiate a move. Attribute 1 must be set to 07. 


Table 5-27.9 Command Block — Trajectory Command 


Attr ID Need in Access Name Data Type | Description of Semantics of Values 
Implementation | Rule Attribute 

3 Required for Set Target DINT Target Position. | Profile destination defined 
Command 07 Position in position Units 

4 Required for Set Target DINT Target Velocity. | Profile velocity defined in 
Command 07 Velocity profile units per second. 

5 Required for Set Incremental |BOOL Absolute / 0 = absolute position, 
Command 07 Incremental flag. | 1 = incremental position 


5-27.3.8 Trajectory Command and Wait - 08 


This command is used to initiate a move and wait for completion. Attribute 1 must be set to 08. 


Table 5-27.10 Command Block — Trajectory Command and Wait 


Attr ID Need in Access Name Data Type | Description of Semantics of Values 
Implementation | Rule Attribute 

3 Required for Set Target DINT Target Position. | Profile destination defined 
Command 08 Position in position Units 

4 Required for Set Target DINT Target Velocity. | Profile velocity defined in 
Command 08 Velocity profile units per second. 

5 Required for Set Incremental |BOOL Absolute / 0 = absolute position, 
Command 08 Incremental flag. | 4 = pelative position 

5-27.3.9 Velocity Change Command - 09 
This command is used to initiate a move and wait for completion. Attribute 1 must be set to 09. 


Table 5-27.11 Command Block — Change Command 


Attr ID Need in Access Name Data Type | Description of Semantics of Values 
Implementation | Rule Attribute 
3 Required for Set Target DINT Target Velocity. | Profile velocity defined in 
Command 09 Velocity profile units per second. 
5-27.3.10 Goto Home Command - 10 


This command is used perform a move to the captured Home position. Attribute 1 must be set 
to 10. 


Table 5-27.12 Command Block — Goto Home Command 
Attr Need in Access Name Data Description of Semantics of Values 
ID | Implementation | Rule Type Attribute 

3 Required for Set Home Offset | DINT Home Position | The offset plus the captured 

Command 10 Offset Home position equals the 
absolute target position. 

4 Required for Set Velocity DINT Target Velocity. | Profile velocity defined in 

Command 10 profile units per second. 
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5-27.3.11 Goto Index Command - 11 


This command is used perform a move to the captured Index position. Attribute 1 must be set 
to 11. 


Table 5-27.13 Command Block — Goto Index Command 
Attr Need in Access Name Data Description of 
ID | Implementation | Rule Type Attribute 
3 Required for Set Index Offset | DINT Index Position | The offset plus the captured 
Command 11 Offset Index position equals the 
absolute target position. 
4 Required for Set Velocity DINT Target Velocity. | Profile velocity defined in 
Command 11 profile units per second. 


5-27.3.12 Goto Registration Position Command - 12 


Semantics of Values 


This command is used perform a move to the captured Registration position. Attribute 1 must 
be set to 12. 


Table 5-27.14 Command Block — Goto Registration Position Command 


Attr Need in Access Name Data Description of 
ID | Implementation | Rule Type Attribute 
e 


3 Required for Set Registration Registration The offset plus the captured 
Command 12 Offset Position Offset | Registration position equals the 
absolute target position. 


4 Required for Set Velocity DINT Target Velocity. | Profile velocity defined in 
Command 12 profile units per second. 


5-27.3.13 Common Services 


Semantics of Values 


Table 5-27.15 Command Block Common Services 
Need in Description of Service 


Name Service 
Implementation Code 


Required Get_Attribute_Single Returns the contents of the specified attribute 
Required Set_Attribute_Single Modifies the attribute value. 


See Appendix A for definitions of these services 
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5-28 Motor Data Object 
Class Code: 28 hex 


This object serves as a database for motor parameters. 


5-28.1 Class Attributes 


Table 5-28.1 Motor Data Class Attributes 


Attribute Need in Access Name Data Type | Description of Semantics of 
ID Implementation | Rule Attribute Values 


1thru7 | These class attributes are optional and are described in Chapter 4 of this specification. 


5-28.2 Instance Attributes 


The Motor Data Instance Attribute set varies depending on the type of motor that the object is 
representing. Instance attribute 3 “MotorType” is required, and its value determines the motor 
specific attributes that are available for that motor type. For all motor types, Attributes 1-5 are 


the same. 


Table 5-28.2 Motor Data Instance Attributes 


Attr Need in Access Name Data Type Description of Attribute 
ID Implem Rule 


1 | Conditional | JUSINT | Number of Attributes supported 


2 Conia NV _ | Attributes Array eon List of attributes supported 
USINT 


3 | Required Set/Get |NV_ | MotorType USINT 0 - Non-standard motor 
1- PM DC Motor 
2 - FC DC Motor 
3 - PM Synchronous Motor 
4 - FC Synchronous Motor 
5 - Switched Reluctance Motor 
6 - Wound Rotor Induction Motor 
7 - Squirrel Cage Induction Motor 
8 - Stepper Motor 
9 - Sinusoidal PM BL Motor 
10 - Trapezoidal PM BL Motor 


4 | Optional Set/Get |NV_ | CatNumber SHORT_ Manufacturer's Motor Catalog Number 
pe eee eee | (Nameplate number) 32 chars max 

5 | Optional Set/Get |NV_ | Manufacturer SHORT_ Manufacturer's Name 32 chars max 
eee eee pe sree 


— 5-197 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 3 


Motor Data Object, Class Code: 28x 
5-28.2.1 Motor Type Specific Motor Data Instance Attributes 


Different motor types require different data to describe the motor. For example, AC Induction 
motors do not need field current data like a DC motor to describe the motor. For this reason, 
motor data attributes that are numbered greater than 5 are described separately for different 
classes of motors. The following table shows the classes of motors described in this 
specification. Other motor classes and types will be described in future revisions of this 
specification. 


Table 5-28.3 Motor Type Specific Motor Data Instance Attributes 


Motor Class Motor Types in Class Section Reference 


AC Motor 3-PM Synchronous 5-28.2.1.1 
6 - Wound Rotor Induction 


7 - Squirrel Cage Induction Motor 


DC Motor 1-PM DC Motor 5-28.2.1.2 
2 - FC DC Motor 


5-28.2.1.1 AC Motor Instance Attributes 
Table 5-28.4 AC Motor Instance Attributes 


Attr | Need in Access Name Data Description of Attribute 
I el Rule awe 


i) 


6 [Required |SevGet | NV |RatedCurrent | [UINT | Rated Stator Current Units: [100mA] 

7 [Required |SevGet | NV | RatedVoltage ont | Rated Base Voltage Units: [V] 

8 UDINT Rated Power at Rated Freq Units: [W] 

9 RatedFreq UINT Rated Electrical Frequency Units: [Hz] 

10 | Optional | Set/Get NV | RatedTemp UINT Rated Winding Temperature 
Units: [ degrees C] 

11 |Optional | Set/Get NV | MaxSpeed UINT Maximum allowed motor speed Units: 
[RPM] 

13 | Optional | Set/Get NV | TorqConstant UDINT Motor torque constant Units: [0.001 x 
Nm/A] 

15 |Optional | Set/Get NV | BaseSpeed UINT Nominal speed at rated frequency from 
See eee [RPM] 

20 |Optional | Get International vin Catalog Name or Number 

CatNumber 
21 |Optional | Get Internation! STRIN Name of Motor Manufacturer 
Manufacturer Name 
22 |Optional | Set NV | SerialNumber SHORT _ | Name Plate Serial Number of Motor (32 
STRING __ | characters or less) 
23 |Optional | Set NV | TagName SHORT _ | Plant’s Tag Name of Motor (32 characters 
STRING _}or less) 


24 SupplyStyle BOOL 0 = three phase, 1 = single phase 


Optional | Set NV | TimeRating UINT Maximum Continuous Operation Time (in 
minutes) 
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Motor Data Object, Class Code: 28x 


Need in Access 
Implem Rule 


Attr 
ID 


26 
27 


i 


29 


DC Motor Instanc 


NV Name Data 
Type 


NV | LockedRotor 
CodeLetter 


NV | DesignLetter SHORT 
STRING 
Thermal Protection | BOOL 


e Attributes 


STRING 


Table 5-28.5 DC Motor Instance Attributes 


Attr | Need in Access 
ID Implem Rule 


Optional | Set/Get 


Optional | Set/Get 


: 


: 
i 
; 
: 


: 
: 
: 


N 


oe) 


10 


11 


22 


NV Name Data 
Type 
- ce 
a RatedVoltage UINT 
RatedPower 
N 


arn ie 


NV 
N 
NV | RatedTemp UINT 
NV | MaxSpeed UINT 
i — 
- ia 
Vv N 
NV | RatedFieldCur DINT 
NV | MinFieldCur UDINT 
NV | RatedFieldVolt UINT 
NV | International STRINGI 
CatNumber 
NV | Internation] STRINGI 
Manufacturer Name 
NV | SerialNumber SHORT 
STRING 
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Description of Attribute 


Maximum inrush current, Units: [100mA] 
NEMA MG-1 Code Letter [MG1-10.37.2] 


The single ASCII character corresponding 
to the Code Letter for Locked Rotor kVA 


IEC or NEMA Design Letters 


TRUE when motor is marked “Thermally 
Protected” 


Description of Attribute 


Rated Armature Current 
Units: [100mA] 

Rated Armature Voltage 
Units: [V] 

Rated Power at MaxSpeed 
Units: [W] 


Rated Winding Temperature 
Units: [ degrees C] 

Maximum allowed motor speed 
Units: [RPM] 

Motor torque constant 

Units: [0.001 x Nm/A] 

Rotor Inertia 

Units: [10-6 x kg.m2] 
Nominal speed at rated voltage 
Units: [RPM] 

Rated Field Current 

Units: [mA] 

Minimum Field Current 

Units: [mA] 

Rated Field Voltage 

Units: [V] 


Catalog Name or Number 


Name of Motor Manufacturer 


Name Plate Serial Number of Motor (32 
characters or less) 
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ae Need in | Access Name Data Description of Attribute 
Implem Rule Type 
Optional V | TagName SHORT _ | Plant’s Tag Name of Motor (32 characters 
STRING jor me 


24 [Optional [Set | NV | SupplyStyle BOOL = three phase, 1 = single phase 


25 |Optional | Set NV | TimeRating UINT Maximum Continuous Operation Time (in 
minutes) 


26 = S| UINT Maximum inrush current, Units: [100mA] 
27 | Optional NV | LockedRotor SHORT NEMA MG-1 Code Letter [MG1-10.37.2] 
CodeLetter STRING | The single ASCII character corresponding 
to the Code Letter for Locked Rotor kVA 

2 Optional NV | DesignLetter SHORT IEC or NEMA Design Letters 

STRING 
Optional | Set NV | Thermal Protection | BOOL TRUE when motor is marked “Thermally 
Protected” 


The following engineering abbreviations are used in the above Motor Data Instance Attribute 
descriptions. 


oe) 


Table 5-28.6 Abbreviations Used in This Object 


Abbreviation Description 
mA milli Amps 
Vv Volts 
RPM Revolutions Per Minute 
Kg.m2 kilograms times meters squared 
Nm/A Newton meters per Amp 
Degrees C degrees Centigrade 
Hz Hertz 
WwW Watts 


5-28.3 Common Services 


Table 5-28.7 Motor Data Object Common Services 


Need in Service Name Description of Service 
Service Implementation 


OEhex Get_Attributes_Single | Returns the contents of the specified attribute. 
10hex | n/a Set_Attributes_Single | Modifies an attribute value. 


15hex | n/a Optional | Restore Restores attribute values from a storage location 
accessible by the Save service. Service is only 
available if the Control Supervisor Object of the 


drive is in the Ready or Wait_Power states. 
16hex Optional | Save Saves all attribute values to a location accessible 
by the Restore service. 


* The Get_Attribute_Single service is required at the class level if any class attributes are implemented 


See Appendix A for definitions of these common services. 
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Motor Data Object, Class Code: 28x 
5-28.4 Object—specific Services 


The Motor Data object provides no object specific services. 


5-28.5 Behavior 


The Motor Data Object serves only as an internal database for motor parameters, which are 
accessed by other objects in the drive. 
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5-29 


5-29.1 


5-29.2 


Control Supervisor Object, Class Code: 29pex 


Control Supervisor Object 
Class Code: 29 hex 


This object models all the management functions for devices within the “Hierarchy of Motor 
Control Devices”. The behavior of motor control devices is described by the State Transition 
Diagram and the State Event Matrix (see Section 5-29.5). 


Class Attributes 


Table 5-29.1 Control Supervisor Object Class Attributes 


Attribute Need in Access Name Data Type Description of Semantics of 
ID Implementation | Rule Attribute Values 


1thru7 | These class attributes are optional and are described in Chapter 4 of this specification. 


Instance Attributes 


Table 5-29.2 Control Supervisor Object Instance Attributes 


Attr Need in Access | NV Name Data Description of Attribute 
ID mes Rule Type 


1 a [USINT | Number of Attributes supported 
2 Optional Attributes Array esis List of attributes supported 
USINT 

5 Optional NetCtrl poor | Requests Run/Stop control to be local or 
from network. 
0 = Local Control 
1 = Network Control 
Note that the actual status of Run/Stop 
control is reflected in attribute 15, 
CtrlFromNet. 

6 


Optional State USINT | 0 = Vendor Specific 
1 = Startup 
2 = Not_Ready 
3 = Ready 
4 = Enabled 
5 = Stopping 
6 = Fault_Stop 
7 = Faulted 
vi Required for | Get Running1 BOOL 1 = (Enabled and Run1) or 
Drives and (Stopping and Running1) or 
Servos only 
(Fault_Stop and Running1) 
ime 0 * Other stale 
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ae Need in Access Name Data 
Implem Rule Type 
| 7 alle 7 
10 ial for Faulted BOOL 
Drives and 
Servos only 
| fin - 
12 | Required for FaultRst BOOL 
Drives and 
Servos only 
13 | Optional on FaultCode UINT 
14 | Optional ! WarnCode UINT 
15 | Optional ai CtrlFromNet |BOOL 
16 | Optional NetFaultMode | USINT 
2k 
17 eee eee BOOL 
ae 
i =| staal 
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Description of Attribute 


= (Enabled and Run2) or 

(Stopping and Running2) or 
(Fault_Stop and Running2) 

0 = Other state 

1 = Ready or Enabled or Stopping 

O = Other state 

1 = Fault Occurred (latched) 

0 = No Faults present 


1 = Warning (not latched) 
0 = No Warnings present 


If warnings are not supported, this attribute 
should always be 0 


0->1 = Fault Reset 


0 = No action 


If in Faulted state, FaultCode indicates the 
fault that caused the transition to Faulted 
state. If multiple faults occurred 
simultaneously, the vendor chooses which 
to report, and the rest are lost. If not in 
Faulted state, FaultCode indicates the fault 
that caused the last transition to the 
Faulted state. 


Power up state of fault code is vendor 
specific. 

Fault codes for drives are different than 
fault codes for starters. 


See appropriate device profile for fault 
codes. 


Code word indicating warning present. If 
multiple warnings are present, the lowest 
code value is displayed. 


Note that fault codes for drives and servos 
are different than fault codes for starters. 


See appropriate device profile for fault 
codes. 


Status of Run/Stop control source. 
0=Control is local 
1=Control is from network 
Action on loss of CIP Network 
0 = Fault + Stop 

= Ignore (Warning Optional) 
2= Vendor specific 


0 ->1 = Force 


0 = Not Forced 


Nonzero = Forced 


Ltd. 
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Attr Need in Description of Attribute 

ID Implem 

19 | Optional Time delay before any fault or idle mode 
action occurs after the fault of idle event is 
detected. 

20 | Optional Mode on reception of CIP communication 
IDLE event — See semantics below. 

21 | Optional Mode on detection of a motor protection 
event — See semantics below. 


22 | Optional Number of operations (motor starts) on the 
equipment. This value shall be zero at the 
time of manufacture. This value may be 
settable to other values. This attribute is 
incremented each time a motor start 
activity occurs (eg: the starter causes a 
motor to begin turning, change direction or 
speed) 


23 iti Fault/Warning |USINT | Identifies the error and warning codes 
Code Style produced by this instance of Control 
Supervisor 
Default = 0 


* these attribute values shall be maintained through power cycles 


5-29.2.1 Operation Mode Values 


The three modes of operation attributes above (number 16, 20 and 21) describe the mode or 
action that the control supervisor shall assume after specific events. These modes of operation 
are also coupled with the Delay attribute. The attribute semantics of the NetFaultMode, 
NetIdleMode and ProtectionMode are as enumerated below: 


Table 5-29.3 Operation Mode Values 


Mode Action Error/Warning 
0 Stop Fault Code 
1 Ignore (Warning Optional) Warning Code optional 
2 Vendor specific action Error and Warning optional 
3 Run 1 (Invalid for ProtectMode Attribute) Fault Code 
4 Run 2 (Invalid for ProtectMode Attribute) Fault Code 
5 thru 99 Reserved by CIP 
100 thru 199 Vendor specific action Error and Warning optional 
200 thru 255 Reserved by CIP 


5-29.2.2. NetFaultMode Attribute 


The NetFaultMode attribute establishes the mode of operation (see Table 5-29.3, Operation 
Mode Values) on loss of network communication. The default value for this attribute is zero. If 
the is attribute is not implemented, the behavior of the control supervisor shall be the “Stop” 
mode. 


If the Delay attribute is both implement and non-zero, the mode specified will be active only 
after a time specified by the delay has expired. 
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Control Supervisor Object, Class Code: 29pex 
5-29.2.3 NetIdleMode Attribute 


The NetIdleMode attribute establishes the mode of operation (see Table 5-29.3, Operation 
Mode Values) on reception of network Idle communication. The default value for this attribute 
is zero. If this attribute is not implemented, the behavior of the control supervisor shall be the 
“Stop” mode. 


If the Delay attribute is both implement and non-zero, the mode specified will be active only 
after a time specified by the delay has expired. 


5-29.2.4 ProtectMode Attribute 


The ProtectMode attribute establishes the mode of operation (see Table 5-29.3, Operation 
Mode Values) on reception of a motor protection event. The default value for this attribute is 
zero. If this attribute is not implemented, the behavior of the control supervisor shall be the 
“Stop” mode. 


If the Delay attribute is both implement and non-zero, the mode specified will be active only 
after a time specified by the delay has expired. 


5-29.2.5 Fault/Warning Code Style Attribute 


The Fault/Warning Code Style attribute is used to indicate the identification of which types of 
Fault and/or Warning codes are produced by this instance of the Control Supervisor. This 
attribute is optional except in instances where the Fault/Warning Codes utilized is not defined 
by the device profile or is different than the enumerations expected due to the reported device 
profile. 


This attribute has the values shown in Table 5-29.4. 


Table 5-29.4 Fault/Warning Code Styles 


0 Default value. The Fault and Warning Codes presented are | Table 5-29.5 
those implied by the device profile. 
1 The DRIVECOM (16-bit) codes are utilized Table 5-29.8 
2 The Abbreviated (8-bit) codes are utilized Table 5-29.9 
2 thru 255 Reserved by CIP 


The implied Fault and Warning Code usage broken down by device profile are shown in Table 
5-29.5. 


Table 5-29.5 Implied Fault/Warning Code Usage by Device Profile 


O2hex AC Drive DRIVECOM (16-bit) code set 
not assigned | Circuit Breaker Abbreviated (8-bit) code set 
not assigned | Circuit Disconnect Abbreviated (8-bit) code set 

15hex Contactor Abbreviated (8-bit) code set 

13hex DC Drive DRIVECOM (16-bit) code set 
not assigned | Fuse Abbreviated (8-bit) code set 
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O3hex Motor Overload Abbreviated (8-bit) code set 

16hex Motor Starter Abbreviated (8-bit) code set 
not assigned | Power Monitor Abbreviated (8-bit) code set 
not assigned | Servo Drive DRIVECOM (16-bit) code set 

17hex Soft Starter Abbreviated (8-bit) code set 


5-29.3 Common Services 


Table 5-29.6 Control Supervisor Object Common Services 


Service | Need in Implementation Service Name Description of Service 


OEhex Get_Attributes_Single Returns the contents of the specified 
attribute. 


10hex n/a Set_Attributes_Single Modifies an attribute value. 
OShex n/a Resets the drive to the start-up state. 


See Appendix A for description of these services 


5-29.4 Object Specific Services 


The Control Supervisor object provides no object specific services. 


5-29.5 Behavior 


The State Transition Diagram provides a graphical description of the states and corresponding 
state transitions. The State Event Matrix lists all events and the corresponding action to be 
taken while in each state. A subset of states and events may be supported in an application but 
the behavior must be consistent. 
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Figure 5-29.1 Control Supervisor Object State Transition Diagram 


Non-Existent Switch Off 


Switch On 


Initialization Complete 


Not_Ready 


A Main Power Off 


Stop 
Complete 
Stopping [ —_ | 


Enabled 


Fault Detected 


Main Power Off 
Reset 


Fault_Stop 
Complete 


Fault Reset 


Fault Detected 


Fault_Stop 


Fault 
Detected 


Main Power On 


Table 5-29.7 Control Supervisor Object State Event Matrix 


State 


Event | Non_Exist | Startup | Not_Ready Enabled Stopping Fault_Stop Faulted 


Switch Off /A Transition to | Transition to | Transition to | Transition to | Transition to | Transition to Transition to 
Non_Exist Non_Exist Non_Exist Non_Exist Non_Exist Non_Exist Non_Exist 


Main Power | N/A N N/A Transition to | Transition to | Transition to | Transition to N/A 
Off Not_Ready | Faulted Faulted Faulted 

Fault N/A Transition to | Transition to | Transition to | Transition to | Transition to | N/A N/A 
Detected Faulted Faulted Faulted Fault_Stop | Fault_Stop 


; 

o Startup 
Complete Not_Ready 
Main Power | N/A N/A Transition to | N/A N/A N/A N/A N/A 
Tipe 
Run * N/A N/A N/A Transition to | N/A Transition to | N/A N/A 

eo Wee ee ee | 
Stopping 
Complete Ready 
Reset N/A N/A Transition to | Transition to | Transition to | Transition to | Transition to Transition to 
aN a = ; 
‘A 


Fault_Stop N/A N/A N/A N/A N/- N/A Transition to | N/A 
Complete Faulted 
Fault Reset N/A N/A N/A N/A N/A N/A N/A Transition to 
Not_Ready 
* See section 5-29.5.1 for further explanation of these events and how they are generated. 
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5-29.6 


Control Supervisor Object, Class Code: 29p¢ex 
Run/Stop Event Matrix 


Attribute 5, NetCtrl is used to request that Run Stop events be controlled from the network. The 
device however, has the option of inhibiting Run Stop events from the network, as the 
user/application may not allow Run Stop control from the network under certain circumstances. 
Only when attribute 15, CtrlFromNet is set to 1 by the device in response to a NetCtrl request, 
is Run Stop control actually accomplished from the network. 


If attribute 15, CtrlFromNet is 1, the events Run and Stop are triggered by a combination of the 
Runi and Run2 attributes as shown in the following table. Note that Run1 and Run2 have 
different contexts for different device types. The following table shows the Run1 and Run2 
contexts for the devices within the motor control hierarchy. 


Table 5-29.8 Run1/Run2 Contexts 


Drives and Servos 


| Contactor | Starter_| Reverser | 2 Speed 


If CtrlFromNet is 0, Run and Stop events must be controlled using local input(s) provided by 
the vendor. The Run and Stop events effect drive behavior as shown in the State Transition 
Diagram and the State Event Matrix. 


Table 5-29.9 Run1 and Run2 Triggers 


RuniA Run2 Trigger Event Run Type 
0 [oC Stop NA 
0->1 lO.8)F))™—™—sSY Run Runl 

0 0->1 Run Run2 
0->1 0->1 No Action NA 

1 l1 =~ __| No Action NA 


1>0 a Run Rn 


1 1->0 Run Runt 


Important note: Local stop and run signals could override or be interlocked with the run/stop 
control through CIP. These are vendor specific features. Vendors should explain these 
interlocks and overrides in their product documentation. 


Fault and Warning codes 


This table lists the fault and warning codes used by AC Drives, DC Drives, and Servos for the 
‘Control Supervisor’ object. The source of the fault codes is the DRIVECOM Nutzergruppe 
e.V, which has granted permission to ODVA to use the fault codes in ODVA device profiles. 
Table 5-29.10 DRIVECOM (16-bit) Fault and Warning Codes 

Code Value [Hex] | Meaning 


0000 No fault 
1000 General Fault 
2000 Current 
2100 Current, Device Input Side 
2110 Short Circuit/Short to Earth 
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Code Value [Hex] | Meaning 


2120 Short to Earth 

2121 Short to earth in Phase L1 
2122 Short to earth in Phase L2 
2123 Short to earth in Phase L3 
2130 Short Circuit 

2131 Short Circuit in Phases L1 -L2 
2132 Short Circuit in Phases L2-L3 
2133 Short Circuit in Phases L3-L1 
2200 Current Inside the Device 
2211 Current inside the device, No. 1 
2212 Current inside the device, No. 2 
2213 Overcurrent during Startup 
2214 Overcurrent during Slowdown 
2220 Continuous Overcurrent 

2221 Continuous Overcurrent No. 1 
2222 Continuous Overcurrent No. 2 
2230 Short Circuit/Short to earth 
2240 Short to earth 

2250 Short Circuit 

2300 Current, Device Output Side 
2310 Continuous Overcurrent 

2311 Continuous Overcurrent, No. 1 
2312 Continuous Overcurrent, No. 2 
2320 Short Circuit/Short to Earth 
2330 Short to Earth 

2331 Short to Earth in Phase U 
2332 Short to Earth in Phase V 
2333 Short to Earth in Phase W 
2340 Short Circuit 

2341 Short Circuit in Phases U-V 
2342 Short Circuit in Phases V-W 
2343 Short Circuit in Phases W-U 
3000 Voltage 

3100 Mains Voltage 

3110 Mains overvoltage 

3111 Mains overvoltage in phase L1 
3112 Mains overvoltage in phase L2 
3113 Mains overvoltage in phase L3 
3120 Mains undervoltage 

3121 Mains undervoltage in phase L1 
3122 Mains undervoltage in phase L2 
3123 Mains undervoltage in phase L3 
3130 Phase Failure 

3131 Failure of Phase L1 

3132 Failure of Phase L2 

3133 Failure of Phase L3 

3134 Phase Sequence 

3140 Mains Frequency 

3141 Mains Frequency too high 
3142 Mains Frequency too low 
3200 Voltage inside the Device 
3210 Overvoltage inside the device 
3211 Overvoltage No. 1 

3212 Overvoltage No. 2 
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Code Value [Hex] | Meaning 


3220 Undervoltage inside the Device 
3221 Undervoltage No. 1 
3222 Undervoltage No. 2 
3230 Charging Error 
3300 Output Voltage 
3310 Output Overvoltage 
3311 Output overvoltage in Phase U 
3312 Output overvoltage in Phase V 
3313 Output overvoltage in Phase W 
3320 Armature Circuit 
3321 Armature Circuit Discontinuity 
3330 Field Circuit 
3331 Field Circuit Discontinuity 
4000 Temperature 
4100 Ambient Temperature 
4110 Excess Ambient Temperature 
4120 Inadequate Ambient Temperature 
4130 Ingoing Ambient Temperature 
4140 Outgoing Air Temperature 
4200 Device Temperature 
4210 Excess Device Temperature 
4220 Inadequate Device Temperature 
4300 Drive Temperature 
4310 Excess Drive Temperature 
4320 Inadequate Drive Temperature 
4400 Power Supply Temperature 
4410 Excess Supply Temperature 
4420 Inadequate Supply Temperature 
5000 Device Hardware 
5100 Power Supply 
5110 Low Voltage Power Supply 
5111 + 15V Power Supply 
5112 +24V Power Supply 
5113 +5V Power Supply 
5120 DC Link Power Supply 
5200 Control 
5210 Measurement Circuit 
5220 Computing Circuit 
5300 Operator Control Circuit 
5400 Power Section 
5410 Output Stages 
5420 Chopper 
5430 Input Stages 
6000 Device Software 
6010 Software Reset (Watchdog) 
6100 Internal Software 
6200 User Software 
6300 Date Set 
6301 Data Set No.1 
6302 ... 630E from 2 to 14 accordingly 
630F Data Set No.15 
6310 Parameter Loss 
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Code Value [Hex] | Meaning 


6320 Parameter Error 

7000 Additional Modules 

7100 Power 

7110 Brake Chopper 

7111 Brake Chopper Failure 

7112 Brake Chopper overcurrent 
7113 Brake Chopper Wiring 

7120 Motor 

7121 Motor Blocked 

7200 Measurement Circuit 

7300 Sensor 

7301 Tacho defective 

7302 Wrong Tacho Polarity 

7303 Resolver 1 defective 

7304 Resolver 2 defective 

7305 Incremental Encoder 1 Defective 
7306 Incremental Encoder 2 Defective 
7307 Incremental Encoder 3 Defective 
7310 Speed 

7320 Position 

7400 Computing Circuit 

7410 Velocity Ramp Generation 
7420 Trajectory Generation Error 
7421 Invalid Parameters 

7422 Trajectory Generator Precalculation 
7423 Trajectory Interpolation 
7500 Communication 

7510 Serial Interface No 1 

7520 Serial Interface No 2 

7600 Data Memory 

8000 Monitoring 

8100 Communication 

8110 Operational Data Monitoring 
8111 No SYNC 

8112 Synchronisation Fault 

8113 No COMMAND 

8114 COMMAND outside window. 
8115 Cannot transmit ACTUAL 
8116 ACTUAL outside window. 
8120 Host Monitoring 

8200 Closed Loop Control 

8300 Torque Controller 

8302 Torque Limiting 

8311 Excess Torque 

8312 Heavy Starting 

8313 Standstill Torque 

8321 Inadequate Torque 

8331 Torque Breakage 

8400 Speed Controller 

8401 Velocity Following Error 
8402 Velocity Limiting 

8500 Position Controller 

8501 Position Following Error 
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Code Value [Hex] | Meaning 


8502 Position Limiting 
8600 Positioning Controller 
8611 Following Error 

8612 Reference Limit 

8700 Synchro Controller 
8800 Winding Controller 
9000 External Malfunction 
F000 Additional Functions 
FOOL Deceleration 

F002 Inadequate Synchronization 
F003 Lifting Mechanism 
F004 Open LOOP Control 


Table 5-29.11 Abbreviated (8-bit) Fault and Warning Codes 


Code Value Meaning 

0 NO FAULT 

10 TEST 

11 FORCE TRIP 

12 E-STOP 

13 RESTART RETRIES 

14 SHORT CIRCUIT 

15 AUXILLIARY I/O FAULT 

16 NETWORK POWER 

20 CURRENT TRIP 

21 THERMAL OVERLOAD 

22 PHASE LOSS 

23 PHASE LOSS - A 

24 PHASE LOSS - B 

25 PHASE LOSS - C 

26 PHASE IMBALANCE 

27 GROUND FAULT 

28 JAM 

29 UNDERLOAD 

30 MOTOR PLUG ATTEMPT 

31 STALL 

32 PHASE TO PHASE SHORT 

33 PHASE TO GROUND SHORT 

40 CONTROL VOLTAGE 

41 CONTROL UNDERVOLTAGE 

42 CONTROL OVERVOLTAGE 

43 FREQUENCY 

44 SPEED SWITCH 

50 MAIN VOLTAGE 

51 UNDERVOLTAGE 

52 OVERVOLTAGE 

53 IMBALANCE 

54 PHASE REVERSAL 

55 FREQUENCY 

56 OVERPOWER 
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Code Value Meaning 
57 UNDERPOWER 
58 VAR 
60 HARDWARE 
61 ILLEGAL FLC SETTING 
62 MEMORY FAULT 
63 HARDWARE LINK FAULT 
64 NO DEVICE POWER 
65 WATCHDOG TIMEOUT 
66 INTERNAL COMPONENT OVER TEMPERATURE 
67 TEMPERATURE SENSOR FAULT 
68 TEMPERATURE SENSOR LOSS 
69 INTERNAL COMMUNICATION/CONTROL LOST 
70 MISC 
71 FAIL TO CLOSE 
72 FAIL TO OPEN 
73 STARTS/HOUR EXCEEDED 
74 LOW POWER FACTOR 
75 STATOR OVERTEMP 
76 BEARING OVERTEMP 
77 INCOMPLETE SEQUENCE 
78 CONTACTOR #2, FAILED TO CLOSE 
79 CONTACTOR #2, FAILED TO OPEN 
80 CONTACTOR #3, FAILED TO CLOSE 
81 CONTACTOR #3, FAILED TO OPEN 
82 STATOR WINDING SHORT 
83 MOTOR BEARING FAULT 
84 EXCESSIVE VIBRATION 
85 UNSTABLE DRIVEN LOAD 
86 LOOSE MOTOR ROTOR BAR 
87 CENTRIFUGAL UNBALANCE 
88 ROTATIONAL UNBALANCE 
89 MOTOR/LOAD MISALIGNMENT 
90 MOTOR OPERATING OUTSIDE LOAD PROFILE 
91 HIGH HARMONIC DISTORTION 
92 MOTORING (MOTOR=GENERATOR OR NEGATIVE CURRENTS 


* Note Fault Codes 101 to 255 are Vendor Specific Codes 
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5-29.7. Object-specific General and Extended Status Codes 


5-29.12 Object-specific General and Extended Status Codes 


General 
Status Codes 
(in hex) 


DO 


D1 


D2 


D3 


8-bit/16-bit 
Associated 
Extended Status 
Codes 


See Table 5-29.10 


See Table 5-29.10 


See Table 5-29.11 


See Table 5-29.11 


Status Name 


General Codes 


DRIVECOM 
Warning Code 


DRIVECOM 
Fault Code 


Abbreviated 
Warning Code 


Abbreviated Fault 
Code 


— 5-215 - 
Edition 3.3 


Description of Status 


Defined by CIP specification in Appendix B 
Reserved Extended Status Codes 
Vendor specific Extended Codes 


Used with all General Codes when required and no 
other Extended Code is assigned 


The Extended Status Code is a DRIVECOM (16-bit) 
Warning code 


DRIVECOM (16-bit) Warning Code 

The Extended Status Code is a DRIVECOM (16-bit) 
Fault code 

DRIVECOM (16-bit) Fault Code 


The Extended Status Code is an Abbreviated (8-bit) 
Warning Code 


Abbreviated (8-bit) Warning Code 


The Extended Status Code is an Abbreviated (8-bit) 
Warning Code 


Abbreviated (8-bit) Warning Code 


ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 4 


AC/DC Drive Object, Class Code: 2Apex 


5-30 AC/DC Drive Object 
Class Code: 2A hex 


This object models the functions specific to an AC or DC Drive. e.g. speed ramp, torque 
control etc. 


5-30.1 Class Attributes 


Table 5-30.1 AC/DC Drive Object Class Attributes 
Attribute 


Need in Access Name Data Type | Description of 
ID Implementation | Rule Attribute 


1 thru 7 | These class attributes are optional and are described in Chapter 4 of this specification. 


Semantics of 
Values 


5-30.2 Instance Attributes 


Table 5-30.2 AC/DC Drive Object Instance Attributes 


Es Need in | Access Name Data Type Description of Attribute 
apie Rule 


ca | USINT | Number of Attributes supported 


2 | Optional Attributes Array — List of Attributes supported 
USINT 
Optional Get AtReference BOOL 1 = Drive actual at reference (speed or 
torque reference) based on mode 


4 | Required Set/ Get NetRef BOOL Requests torque or speed reference to be 
local or from the network. 
0 = Set Reference not DN Control 
1 = Set Reference at DN Control 
Note that the actual status of torque or 
speed reference is reflected in attribute 29, 
RefFromNet. 
5 | Optional Set/ Get NetProc BOOL Requests process control reference to be 
local or from the network. 
0 = Set Process not DN Control 
1 = Set Process at DN Control 
Note that the actual status of the process 
control reference is reflected in attribute 30, 
ProcFromNet. 
Required Set/ Get DriveMode USINT 0 = Vendor specific mode 
1 = Open loop speed (Frequency) 
2 = Closed loop speed control 
3 = Torque control 
4 = Process control (e.g. PI) 
5 = Position control 


7 | Required SpeedActual Actual drive speed (best approximation) 
Units: RPM / 25PeeScale 
where SpeedScale is attribute 22 


8 | Required Set/ Get SpeedRef Speed reference 
Units: RPM / 2°Pee4Scale 
where SpeedScale is attribute 22 


BR 


w 


an 
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ttr Need in | Access | NV Name Data Type Description of Attribute 
| toes | eae|| | PP 
9 | Optional Get CurrentActual INT Actual motor phase current 

Units: 100ma / 2005" 

where CurrentScale is attribute 23 
10 | Optional Set/ Get CurrentLimit INT Motor phase current limit 

Units: 100ma/ pCurrentScale 

where CurrentScale is attribute 23 
11 | Optional Get TorqueActual INT Actual torque 

Units: Nm / 2 ruescale 

where TorqueScale is attribute 24 
12 | Optional Set/ Get TorqueRef INT Torque reference 

Units: Nm / pTorqueScale 

where TorqueScale is attribute 24 
13 | Optional Get ProcessActual INT Actual process control value 

Units: % / pProcessScale 

where ProcessScale is attribute 25 
14 | Optional Set/ Get ProcessRef INT Process control reference set point 

Units: % / pProcessScale 

where ProcessScale is attribute 25 
15 | Optional Get PowerActual INT Actual output power 

Units: Watts / g Cee 

where PowerScale is attribute 26 
16 | Optional Get InputVoltage INT Input Voltage 

Units: Volts / 2” °'8°Se 

where VoltageScale is attribute 27 
17 | Optional Get OutputVoltage INT Output Voltage 

Units: Volts / 28° 

where VoltageScale is attribute 27 
18 | Optional Set/ Get AccelTime UINT Acceleration time 

Time from 0 to HighSpdLimit 

Units: ms / pene 

where TimeScale is attribute 28 

Acceleration time selection for negative 

direction is vendor specific. 
19 | Optional Set/ Get DecelTime UINT Deceleration time 

Time from 0 to HighSpdLimit 

Units: ms / 27meScale 

where TimeScale is attribute 28 

Deceleration time selection for negative 

direction is vendor specific. 
20 | Optional Set/ Get LowSpdLimit UINT Minimum speed limit 

Units: RPM / 2°Pee4Sale 

where SpeedScale is attribute 22 
21 | Optional Set/ Get HighSpdLimit UINT Maximum speed limit 

F SpeedScale 

Units: RPM / 2 

where SpeedScale is attribute 22 
22 |Optional* | Set/ Get SpeedScale SINT Speed scaling factor. Scaling is 

accomplished as follows: 

ScaledSpeed = RPM / 2°?eedScale 

Range: -128 .. 127 
23 |Optional* | Set/ Get CurrentScale SINT Current scaling factor. Scaling is 

accomplished as follows: 

ScaledCurrent = A / 2°U7emScale 

Range: -128 .. 127 
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ttr Need in | Access | NV Name Data Type Description of Attribute 
| teen [ie ||| 
24 |Optional* | Set/ Get TorqueScale SINT Torque scaling factor. Scaling is 
accomplished as follows: 
ScaledTorque = Nm / Ns aa 
Range: -128 .. 127 
25 |Optional* | Set/ Get ProcessScale SINT Process scaling factor. Scaling is 
accomplished as follows: 
ScaledProcess = % / 2/7ocesssale 
Range: -128 .. 127 
26 |Optional* | Set/ Get PowerScale SINT Power scaling factor. Scaling is 
accomplished as follows: 
ScaledPower = W / 2Powerscale 
Range: -128 .. 127 
27 |Optional* | Set /Get VoltageScale SINT Voltage scaling factor. Scaling is 
accomplished as follows: 
ScaledVoltage = V / gees 
Range: -128 .. 127 
28 |Optional* | Set/ Get TimeScale SINT Time scaling factor. Scaling is 
accomplished as follows: 
ScaledTime = ms / 2™™¢S¢l* 
Range: -128 .. 127 
29 | Optional Get RefFromNet BOOL Status of torque/speed reference 
0=Local torque/speed reference 
ae lie i | 1=Network torque/speed reference 
30 | Optional Get ProcFromNet BOOL Status of process control reference 
0=Local process reference 
lade eo wed 1=Network process reference 
31. | Optional Set/ Get FieldIorV BOOL Selects Field Voltage or Field Current 
control for a DC Drive. 
0=Voltage Control (Open Loop) 
1=Current Control 
(Magnetizing field for DC drive) 
32 |Optional |Set/Get| | FieldVoltRatio | = UINT _| For voltage control of a DC Drive 
33 | Optional Set/ Get FieldCurSetPt UINT DC Drive Field Current set point. 
a ell aie ies ae ae 
where CurrentScale is attribute 23 
34 | Optional Set/ Get FieldWkEnable BOOL Enables/Disables field weakening for a DC 
Drive 
0=Disabled (DC Drive in current control) 
35 | Optional Get FieldCurActual INT Actual Field Current for a DC Drive. 
Units: Amps / yCurentScale 
where CurrentScale is attribute 23 
36 | Optional Set/ Get FieldMinCur INT Minimum Field Current for a DC Drive. 
Units: Amps / CurrentScale 
where CurrentScale is attribute 23 
37 Optional Set NV |Process Data ENGUNITS Applies to: 
Units ProcessActual 
ProcessRef 
Values specified in Volume I Appendix D. 
38 Optional Set NV |Speed Control |BYTE Set bits are used to request speed commands. 
See Semantics section. 
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= Need in | Access Name Data Type Description of Attribute 
Implem Rule 


39 Optional Speed Status BYTE Set bits indicate the current speed status. 
see Semantics section. 
40 Optional Set NV |Speed Trip UINT Time for SpeedActual beyond vendor 
Time specific hysteresis band. See Behavior 
section. 
Units: ms / 27meScale 
where TimeScale is attribute 28 
41 Optional Get NV | Max Rated INT Vendor Specific maximum rating. 
Speed Units: RPM / QMRSScale 
where MRSScale is attribute 46 
42 Optional Set NV | Max Rated SINT Speed Scaling for the Maximum Rating. 
Speed Scale Scaling is accomplished as follows: 


ScaledSpeed = RPM / 2M8Sscale 
Range: -128 .. 127 


43 Optional Set NV |SpeedStandby |INT Speed setting for Standby. See Behavior 
section. 


Units: RPM / 25PeedScale 
where SpeedScale is attribute 22 


44 Optional Set NV |SpeedActual ENGUNITS Allows a change from RPM 
Data Units RPM [default] 


Applies to: 
SpeedActual 
SpeedStandby 


Values specified in Volume I Appendix D 
45 Optional Set NV |SpeedRef Data |ENGUNITS Allows a change from RPM 
Units RPM [default] 


Applies to: 
SpeedRef 

Max Rated Speed 
LowSpdLimit 
HighSpdLimit 


Values specified in Volume I Appendix D. 
46 Optional Get NV | Drive On Hours | DINT Number of hours SpeedActual > 0 


Value shall not "roll over" at terminal count 


* See section 5-30.5.1. for scaling example. 


The basic units used by the AC/DC Drive Object are: 


Table 5-30.3 Basic Units 


Physical Quantity Units 
Speed: RPM Revolutions Per Minute 
Current: 100 milliAmps 
Torque: Newton Meters 
Process control: % Percent 
Power: Watts 
Voltage: Volts 
Time: Milliseconds 
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5-30.2.1.1 


5-30.3 


AC/DC Drive Object, Class Code: 2Apex 


Semantics 


Speed Control and Speed Status 


The Speed Control attribute is used to request various commands for the speed objective of the 
AC/DC Drive object. The value of the Speed Status attribute indicates the current speed status. 
See Behavior section for more information. Setting a bit to TRUE effects the request for the 
respective speed. A request to set the Speed Control attribute to an unsupported bit pattern 
(i.e., representing a command that the object does not support) shall yield an Invalid Attribute 
Value error response. 


Table 5-30.4 Speed Control Attribute and Speed Status Attribute Bit Map 


SpeedActual is increasing 
7 SpeedActual is decreasing 


* value shall be ignored 
** corresponds to the AtReference attribute (ID 3). 


Ayup~R][wlNyhnyrtlo 


When these attributes (Speed Control and Speed Status) are supported by a device with a 
Control Supervisor object, Speed Control Bit 0 corresponds to Run1 (Control Supervisor 
instance attribute ID 3) and Speed Status Bit 0 corresponds to Running1 (Control Supervisor 
instance attribute ID 7). 


Some implementations may support only some values of Speed Status. For example, At Idle 
and Stopped may always be set together (i.e., no difference between these two status 
conditions). A detailed description of the actual behavior corresponding to these speed 
conditions is vendor specific. 


Common Services 


Table 5-30.4 AC/DC Drive Object Common Services 


Service | Need in Implementation Service Name Description of Service 
OEhex Get_Attributes_Single Returns the contents of the specified attribute. 


10hex n/a Set_Attributes_Single Modifies an attribute value. 


15hex n/a Optional | Restore Restores attribute values from a storage location 
accessible by the Save service. This service is 
only available if the drive is in the Ready or 
NOT_READY states. 


16hex Optional | Save Saves all attribute values to a location accessible 
by the Restore service. 


See Appendix A for definition of these services 
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5-30.4 Object-specific Services 


The AC/DC Drive object provides no object specific services. 


5-30.5 Behavior 


The following drawing represents the signal flow in an AC drive whose output is an inverter 
frequency command. Signal flow is controlled by the AC/DC Drive Instance attributes shown 
in Bold type. The process and speed references can be directed to originate from network 
commands or from references internal to the drive or supplied to the drive through terminal 
blocks or keypads. Network control of these alternative reference sources will be vendor 
specific. The mode of operation can also be controlled from the network with the mode 
attribute AC/DC Drive object. Note that not all modes will be supported by all drives. 


Table 5-30.5 AC/DC Drive Object Behavior - Frequency Inverter 


6) DriveMode=1,2 6) DriveMode=1 ~ 


8) SpeedRef 


Frequency 
(From network) —#———»@—_______e Accel/Decel —_+—¥!§_.— 
Used when Circuit i 
4) NetRef = 1 \ other reference oot ne ® ey ia 
(not from network) 3 ; “eg 
Used when 6) DriveMode=4 
4) NetRef = 0 
18) AccelTime 4 sun Ga ae 4) 6) DriveMode=5 
t+ 19) DecelTime urrentActual and/or 
ea aa) LowSpdLimit 10) CurrentLimit and/or 
Ww 
Used when lama. Regulator 21) HighSpdLimit 15) PowerActual and/or 


5) NetProc= 1 * otter pateranea 20) LowSpdLimit and/or 
(not from network)|__13) Process Actual or 21) HighSpdLimit and/or 


Used when Other Process Feedback Other Feedback 
5) NetProc = 0 
Position ref or 


commands 
(Vendor specific) 


Vendor specific position regulator 


algorithms (regulators, reference 
generators, etc) 


The following drawing represents the signal flow for a AC or DC torque or current controlled 
drive. These drives can operate in Mode 3, allowing a network torque reference to directly 
control the drive. 


Each drive vendor can implement a process regulator and position regulator to feed either the 
speed regulator or the torque command directly. Broken lines indicate these alternative signal 
paths. 
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Table 5-30.6 AC/DC Drive Object Behavior — Torque or Current Controlled 


12) TorqueRef 
(From network) 


Used when 
4) NetRef = 1 other reference 


(Not from network) 9) CurrentActual and/or 
Used when 10) CurrentLimit and/or 
4) NetRef = 0 11) TorqueActual and/or 
Other Feedback 
6) Mode=3 
6) DriveMode=1,2 a 
8) SpeedRef i Torque or 
(From network) —“+——e————————_e current 


Usedwith  F 2 Circuit Pn] 
4) NetRef = 1 Tomer reference 4 ee 6) Mode=2,4,5 
|e 


(Not from network) 
Used when 18) AccelTime ab ee oe a \ 6)Mode=5 
4) NetRef = 0 19) DecelTime ) CurrentActual and/or 


11) TorqueActual and/or 
15) PowerActual and/or 

20) LowSpdLimit and/or 
21) HighSpdLimit and/or 


. : 20) LowSpdLimit 
6) DriveMode = 4 21) HighSpdLimit 


6) Mode=4 


14) ProcessRef 


(From network) 


Used when f 
5) NetProc = 1 other reference 


(Not from network)| 13) ProcessActual or 
Used when Internal Process Feedback 
5) NetProc = 0 


Broken lines 
indicate alternative 
signal paths. 


Vendor specific position regulator 
algorithms (regulators, reference 


Position ref or 
commands 


as enerators, etc. 
(Vendor specific) 8 ; 


As illustrated below, AccelTime (attribute 18) is defined as the time in seconds it would take 
the drive to accelerate from zero to HighSpdLimit (attribute 21), the maximum speed at which 
the drive is allowed to operate. 


Similarly, DecelTime (attribute 19) is the time to slow down from HighSpdLimit (attribute 
21) to zero speed. 


There will be no guarantee that the drive will operate at these rates in actual applications, since 
current limit may increase the acceleration time, and lack of sufficient braking capability may 
increase the stopping time. 
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Figure 5-30.7 Accel/Decel Time 


HighSpeedLimit 


AccelTime DecelTime 


Mm — Mm — 


cM 


AccelTime DecelTime 


-HighSpeedLimit 


When DriveMode (attribute 6) is set to “1” or “2”, AtReference (attribute 3) is “1” when 
SpeedActual (attribute 7) is at its prescribed speed reference plus or minus a vendor specific 
hysteresis band. The vendor specific hysteresis band may be fixed, programmable, or zero. 


Figure 5-30.8 Vendor Specific Hysteresis Band — Speed Reference 


speed 


speed reference 


1 


AtReference 


0 
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When DriveMode (attribute 6) is set to “3”, AtReference (attribute 3) is “1” when 
TorqueActual (attribute 11) is at its prescribed torque reference plus or minus a vendor 
specific hysteresis band. The vendor specific hysteresis band may be fixed, programmable, or 
ZeT0. 


Figure 5-30.9 Vendor Specific Hysteresis Band — Torque Reference 


torque 
torque reference 


vendor specific hysteresis band 


1 


AtReference 


0 a‘: 1 1 
5-30.5.1 | Enhanced Speed Control Behavior 


The Speed Control attribute is used to request different speed objectives for the AC/DC Drive 
object. With no bits set to True, the objective for the object is to obtain the speed specified by 
the value of the SpeedRef attribute. Other Speed Control bits are used to request alternative 
speed objectives, including: idle, standby and coast. 


For DriveMode=1,2, the Standby alternative speed objective alters the source of the speed 
setpoint (input to Accel/Decel Circuit) from SpeedRef (attribute 8) to SpeedStandby (attribute 
43). 


Irrespective of DriveMode; idle and coast affect the appropriate action by overriding the 
Accel/Decel Circuit. SpeedRef and SpeedStandby are ignored by the Accel/Decel Circuit 
while idle or coasting. 


The Speed Trip Time attribute specifies a time for which the value of SpeedActual may exceed 
the vendor specific hysteresis band before an Speed Trip Condition exists. The particular 
actions and/or behavior modifications associated with an Speed Trip Condition shall be 
specified by the Device Profile. 


5-30.5.2 Scaling of attribute values 


As part of the AC/DC Drive Object definition, engineering units are defined for each physical 
quantity, e.g. RPM for Velocity, Nm for Torque etc. To maximize the resolution capable or 
necessary on some devices or applications, these values can be normalized using a binary scale 
factor before transmission on the bus. A separate scaling factor is specified for each physical 
quantity. Normally, scaling factors will be set up once during initialization according to the 
range of values to be used in the application. 


Scaling Factors allow the representation of physical units on the bus to obtain an acceptable 
resolution and dynamic range for all applications. 
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Example: Configuration of a DC Drive to operate with RPM resolution of 0.125 RPM 


SpeedRef (AC/DC Drive Object, Attribute ID 8) = 4567 
SpeedScale (AC/DC Drive Object, Attribute ID 22) =3 
=> Actual Commanded Speed = SpeedRef / 2 S°°°S“® = 4567/2 °= 570.875 RPM 


Input from Drive to bus: 


Actual Drive Operating Speed = 789.5 RPM 


SpeedScale (AC/DC Drive Object, Attribute ID 22) =3 
= SpeedActual (AC/DC Drive Object, Attribute ID 7) = 
Actual Operating Speed x 2 SP°eS° = 789.5 x 2? = = 6316. 


In cases where the applicable scaling factor attribute is non-zero, the units are: 


Engineering unit /2 Scale Factor Attribute 


In the above example, therefore, the units are 0.125 RPM. 


Drives that do not support scale factors (Attributes 22 ~ 28), should return an “Attribute Not 
Supported” error. In this case, the default scaling is presumed, and all physical quantities will 
then default to engineering units. For example, speed values will then default to units of RPM. 
Drives that do not use RPM as an internal measure should calculate an RPM value based on 
motor parameters. For example, AC VFD’s may calculate an RPM/Hz constant using motor 
rated frequency and motor base speed from theMotor Data Object. An example of this type of 
implementation (including scaling factors) for the commanded VFD’s frequency may be: 


Frequency Command (Hz) = (SpeedRef x RatedFreq) / (2°°°°S“"" x BaseSpeed) 


and an example implementation for the reported operating speed as a function of the output 
frequency may be: 


SpeedActual = Int[ (Output Frequency (Hz) x BaseSpeed x 25?°*5"""*) / RatedFreq | 


Where: 
Frequency Command = the VFD’s resultant frequency command, the resolution of which is 
vendor-dependent. 
SpeedRef = AC/DC Drive Object Instance Attribute ID 8. 
RatedFreq = Motor Data Object, AC Motor Instance Attribute ID 9. 
SpeedScale = AC/DC Drive Object Instance Attribute ID 22. 
BaseSpeed = Motor Data Object, AC Motor Instance Attribute ID 15. 
SpeedActual = AC/DC Drive Object Instance Attribute ID 7. 
Int = A vendor-specific integer typecast function (such as rounding or truncation). 


Output Frequency = the VFD’s reported present operating frequency, the resolution of 
which is vendor-dependent. 
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5-31.1 


5-31.2 


Acknowledge Handler Object, Class Code: 2Brex 


Acknowledge Handler Object 
Class Code: 2B hex 


The Acknowledge Handler Object is used to manage the reception of message 
acknowledgments. This object communicates with a message producing Application Object 
within a device. The Acknowledge Handler Object notifies the producing application of 
acknowledge reception, acknowledge timeouts, and production retry limit. 


Class Attributes 


Figure 5-31.1 Acknowledge Handler Object Class Attributes 


Need in Access Name Data Type Description of 
Implementation | Rule Attribute 


1 thru 7 | These class attributes are optional and are described in Chapter 4 of this specification. 


Semantics of Values 


Class Services 


e Get_Attribute_Single 
e Create 
e Delete 


Figure 5-31.2 Acknowledge Handler Object Common Services - Class Level 
Need in 


Implementation Code 
Optional Get_Attribute_Single OEhex Used to read an Acknowledge Handler Object 
attribute value. 


Optional Used to create an Acknowledge Handler Object. 


Optional Delete O9hex Used to delete all dynamically created Acknowledge 
Handler Object instances. 


See Appendix A for definitions of these services 
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5-31.3 Instance Attributes 


Figure 5-31.3 Acknowledge Handler Object Instance Attributes 
Attr Need in Access Data Description of Attribute Semantics of 
ID Implement Rule Type Values 
1 | Required Set Acknowledge | UINT | Time to wait for acknowledge Range 1-65,535 
Timer before resending ms (0 invalid) 
default = 16 
2  |Required (Get) | Get/Set Retry Limit |USINT | Number of Ack Timeouts to wait | Range 0-255 
Optional (Set) before informing the producing | default = 1 
application of a 
RetryLimit_Reached event. 
3 | Required COS UINT _ | Connection Instance which Connection 
Producing contains the path of the Instance ID 
Connection producing I/O application object 
Instance which will be notified of Ack 
Handler events. 
4 | Optional Get Ack List Size | BYTE |Maximum number of members | 0 = Dynamic 
in Ack List 
>0 = Max 
number of 
members 
5 | Optional Get Ack List List of active connection Number of 
instances which are receiving members 
Acks. followed by list 
of: Connection 
Instance ID 
6 | Optional Get Data with Ack Maximum number of members | 0 = Dynamic 
Path List Size in Data with Ack Path List 
>0 = Max 
number of 
members 


e If the specified value for the Acknowledge Timer attribute is not equal to an increment of 
the available clock resolution, then the value is rounded up to the next serviceable value. 
For example: a Set_Attribute_Single request is received specifying the value 5 for the 
Acknowledge Timer attribute and the product provides a 10 millisecond resolution on 
timers. In this case the product would load the value 10 into the Acknowledge Timer 
attribute. 

e = The value that is actually loaded into the Acknowledge Timer attribute is reported in the 
Service Data Field of a Set_Attribute_Single response message associated with a request to 
modify this attribute. 

e Asuccessful set attribute to the Retry Limit attribute will reset the Retry Counter. 


Data with Ack List of connection Number of 
Path List instance/consuming application | members 
object pairs. This attribute is followed by list 
used to forward data received of: Connection 
with acknowledgment. Instance ID/CIP 
path length/CIP 
path 
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5-31.5 


Acknowledge Handler Object, Class Code: 2Brex 


e ©The Ack List attribute is updated when an associated connection transitions between 
configuring, established, timed-out, and non-existent. Refer to the State Event Matrix for 
details. 

e If the Acknowledge Handler Object is active (at least one member in the Ack List), the 
COS Producing Connection Instance attribute access is get only. 

e ©The default value loaded into the Acknowledge Timer attribute at time of instantiation is 16 
ms. 

e The default value loaded into the Retry Limit attribute at time of instantiation is 1. 


Instance Services 


The Acknowledge Handler Object Instance supports the following Common Services: 


e Get_Attribute_Single 
e = Set_Attribute_Single 
e Delete 


Figure 5-31.4 Acknowledge Handler Object Common Services — Instance Level 


Need in Name Service Description of Service 
Impl Code 
Required | Get_Attribute_Single Used to read an Acknowledge Handler Object attribute value. 


Required Set_Attribute_Single | 10hex Used to modify an Acknowledge Handler Object attribute 


value. 


Optional Used to delete an Acknowledge Handler Object. 


See Appendix A for definition of these services 


Object-specific Services 
The Acknowledge Handler Object Instance also supports the following Object Class Specific 
Services: 


e Add_AckData_Path 
e Remove_AckData_Path 


Figure 5-31.4 Acknowledge Handler Object Object-specific Services 


Need in Name Service Description of Service Service Request 
Impl Code Parameters 


Optional | Add_AckData_Path 4Bhex Adds a path for data with Connection Instance 
acknowledgment for a connected | Crp path Length 
consumer. 

CIP Path 
Optional | Remove_AckData_Path | 4Chex Removes a path with Connection Instance 


acknowledge path for the given 
connected consumer. 


These services are used to add and remove paths for each of the connected acknowledge 
consumers when data is sent with the acknowledgment. 
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5-31.6.1 


Acknowledge Handler Object, Class Code: 2Brex 


Behavior and Configuration of Acknowledged Data Production 


The following rules are used to configure and determine the behavior of an acknowledged 
Change of State or Cyclic I/O connection using the Acknowledge Handler Object. In the 
following examples, COS Producer is used to reference the device producing change of state or 
cyclic data and consuming an acknowledgment (client). COS Consumer is used to reference 
the device consuming the change of state or cyclic data and producing an acknowledgment 
(server). 


Acknowledged Data Production 


1. The COS Producers consumed connection path must be set to an available Acknowledge 
Handler Object. The path must consist of Class and Instance. If an Acknowledge Handler 
Object is not available, use the Acknowledge Handler Class Create service to obtain a new 
one. 


2. The COS Producers producing I/O application informs the Acknowledge Handler Object 
of new data production (Data Sent event message) or data production retries (Data Resent 
event message). 


3. The COS Producers acknowledgment reception is done by the Acknowledge Handler 
Object. The Acknowledge Handler object informs the Producing I/O application when one 
or more acknowledges have not been received within the acknowledge timeout (using the 
Ack List and Ack Timeout attributes). 


4. The acknowledge message requires no data. The COS producing device’s Acknowledge 
Handler object should consider valid message reception as an acknowledgment. However, 
a change of state or cyclic producing device may be configured to consume data along with 
the acknowledgment. In this case the data is forwarded to the application object in the 
‘Data with Ack Path List’ attribute, based on the connection which received the data. 


5. The COS Consumer acknowledge producing application should be configured to send 
either a zero length message or valid response (output) message when a valid input 
message is consumed. 


6. An acknowledge timer is started each time production occurs. The Acknowledge Handler 
object is notified of this event by a Data Sent or Data Resent event message from the 
producing application. 


7. Expiration of the acknowledge timer causes an Acknowledge Timout message to be sent to 
the producing application object. That object must resend the last message if the Retry 
Limit has not been reached. It may also take an application specific action. 


8. The retry count is incremented each time an Acknowledge Timeout message is sent to the 
producing application. When the retry limit has been reached, a Retry Limit Reached 
message is sent to the producing application object. 


9. The retry count is cleared on each Data Sent message. A Data Resent message does not 
clear the retry counter. 


10. The acknowledge timer value is configurable within the Acknowledge Handler object. 
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Acknowledge Handler Object, Class Code: 2Brex 


11. The number of retries is (optionally) configurable within the Acknowledge Handler object. 


Change of State Examples 


Acknowledged Change of State (Using one connection object and one COS 
consumer) 


For the producer: 
1. Create a Connection Object. 


2. The producer transportClass_trigger attribute is set to Class 2/3, Change-Of-State, Client 
(13h for Class 3) or Class2/3, Cyclic, Client (03h for Class 3). 


3. The produced connection path is set to the producing application, which must support 
Change of State or Cyclic production. 


4. Create an Acknowledge Handler object. Configure the ?COS Producing Connection 
Instance’ attribute to the instance of the connection object which specifies the producing 
I/O application object. The Ack List attribute will be updated with the connection instance 
of the I/O connection object which is consuming an acknowledge as that connection 
transitions to the established state. Optionally configure the Acknowledge Timer and 
Retry Count attributes. 


5. The consumed connection path is set to the Acknowledge Handler object just created and 
configured for handling the acknowledge. The path contains Class and Instance only. 


6. The consumed connection size is set to the size of the data expected to be delivered to the 
object specified in the consumed path of the Acknowledge Handler Object, or zero if no 
path is configured. 

7. All other attributes are configured the same way as any other peer to peer connection. 

For the consumer: 


8. The consumer transportClass_trigger attribute is set to Class 2/3, Server (83h for Class 3). 


9. The produced connection path is set to the consuming application (or some other 
application, this is product specific) for generating the acknowledge. 


10. The produced connection size is set to the size of the data to be delivered to the object 
specified in the consumed path of the change of state producing device’s Acknowledge 
Handler object, or zero if no path is configured. 


11. All other attributes are configured the same way as any other peer to peer connection. 
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Acknowledged Change of State (Using multiple connection objects and COS 
consumers) 


For the producer: 
1. Create a Connection Object. 


2. The producer transportClass_trigger attribute is set to Class 0, Change-Of-State, Client 
(10h) or Class 0, Cyclic, Client (00h). 


3. The produced connection path is set to the producing application which must support 
Change of State or Cyclic production. 


4. The consumed connection path and consumed connection size are not configured. 
5. All other attributes are configured the same way as any other peer to peer connection. 
6. Create a Connection Object for each COS consumer. 


7. The consumer transportClass_trigger attribute is set to Class 0, Server (80h) for each 
consuming connection object. 


8. Create an Acknowledge Handler object. Configure the °>COS Producing Connection 
Instance’ attribute to the instance of the connection object which specifies the producing 
I/O application object. The Ack List attribute will be updated with the connection instance 
of each I/O connection object which is consuming an acknowledge as those connections 
transition to the established state. Optionally configure the Acknowledge Timer and Retry 
Count attributes. 


9. The consumed connection path for each consuming connection object is set to the 
Acknowledge Handler object just created and configured for handling the acknowledge. 
The path contains Class and Instance only. 

10. The consumed connection sizes are set to the size of the data expected to be delivered to 
the consumed path set in the Acknowledge Handler Object, or zero if no path is 
configured. 

11. All other attributes are configured the same way as any other peer to peer connection. 

For each consumer: 


12. The consumer transportClass_trigger attribute is set to Class 2/3, Server (83h for Class 3). 


13. The produced connection path is set to the consuming application (or some other 
application, this is product specific) for generating the acknowledge. 


14. The produced connection size is set to the size of the data to be delivered to the consumed 
path set in the change of state producing device’s Acknowledge Handler object, or zero if 
no path is configured. 


15. All other attributes are configured the same way as any other peer to peer connection. 
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Once the Connection Object(s) is (are) configured, an Apply Attributes service is sent to each 
configured Connection Object to transition the connection(s) to the Established state. During 
the apply, the connection object is ’delivered’ to both the consuming and producing application 
objects for validation of the attribute information. At this time, the producing I/O application 
checks for a change of state configuration by examining the transportClass_trigger attribute. If 
the Production Trigger bits are set to change-of-state or cyclic, the application will configure 
itself for change of state or cyclic production. If change of state or cyclic production is not 
supported by the producing application object an error must be returned to the apply_attributes 
service. 


Use of Timers with Acknowledged Data Production 
The following rules must be observed when sending acknowledged data. 
New data not sent while the Inhibit Timer is active (running). 


New data is sent when no acknowledge is pending, subject to rule # 1. (An acknowledge is 
pending after a send of new data or a retry of old data and until an Ack Timeout or Ack 
Received. 


Retry of old data occurs at Ack Timeout if new data is not available or the Inhibit Timer is 
active. 


Sending new data (or old data on transmission trigger timeout) starts the Ack Timer, Inhibit 
Timer, and the Transmission Trigger Timer. The Retry Counter is also cleared. 


A retry of old data starts the Ack Timer. 


Figure 5-31.5 Typical Timing Relationships for Acknowledged Data Production 


Inactivity Timer = 4 x EPR 


Transmission Trigger Timer = EPR 


Production Inhibit Timer 


Ack Ack 
Timeout | Timeout 


Limit 


— 5-232 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 4 
Acknowledge Handler Object, Class Code: 2Brex 


Figure 5-31.6 Example of a COS System, 2 Acking Devices 
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The following diagrams illustrate the message flow in a Change of State connection for both single and 
multi-consumer configurations. 


Figure 5-31.7 Message Flow in COS Connection — One Connection Object, One Consumer 
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Figure 5-31.8 Message Flow in COS Connection —Multiple Consumers 
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The following are the State Event Matrices for the Producing I/O application object and 
Acknowledge Handler object associated with a Change of State connection. 


Figure 5-31.9 SEM for Producing I/O Application Object 


State > Not Running Running Running with Prohibited 
Vente. Acknowledgment 
Change of Ignore Event Inform Link Producer to Inform Link Producer to Send Data. Queue Event 


State Detected 


Send Data. 
If Inhibit Time 
configured 
Start Inhibit Timer 
Transition to Produced 


Send DataSent event message to 
Acknowledge Handler object. 
If Inhibit Time configured 
Start Inhibit Timer transition to 
Prohibited. 


Acknowledge 
Received 


Not Applicable 


Not Applicable 


Ignore Event 


If Ack_Active Set 

If Inhibit Timer not running 
Transition to Running with 
Acknowledgement 

Else 
Set Ack_Receive flag 

Else ignore event 


Acknowledge 
Timeout 


Ignore Event 


Not Applicable 


Inform Link Producer to Send Data 
Send Data_Resent event message to 
Acknowledge Handler Object. 


Inform Link Producer to Send 
Data. 

Send Data_Resent event 
message to Acknowledge 
Handler Object. 


Transmission 
Timer Expires 


Not Applicable 


Inform Link Producer to 
Send Data. 


Inform Link Producer to Send Data. 
Send Data_Sent event message to 
Acknowledge Handler Object. 


Inform Link Producer to Send 
LAST Data Sent. 
Send Data_Sent event message 


to Acknowledge Handler 
Object. 
Retry Limit Ignore Event Not Applicable Product Specific Transition to Running with 
Reached Acknowledgement. 
Inhibit timer | Ignore Event Not Applicable Not Applicable If Ack_Active set 
Expires If Ack_Received 
Transition to Running w/Ack 
Clear Ack_Received flag 
Else Ignore Event 
Else Transition to Running 
Connection Not Applicable Transition to Not Transition to Not Running Transition to Not Running 
Deleted Running 
Acknowledge | Set Ack Active Transition to Running Ignore Event Set Ack_Active Flag 
Active Flag with Acknowledgement 
Set Ack Active Flag 
Acknowledge | Reset Ack Active Ignore Event Transition to Running Reset Ack_Active Flag 
Inactive Flag Reset Ack Active Flag 
Connection If Ack Active Ignore Event Ignore Event Ingore Event 
Transition to Transition to 
Established Running with 
Acknowledgment 
If Ack Inactive 
Transition to 
Running 


Note: This is a partial SEM for a producing I/O application object. Only those states and events associated with data 
acknowledgement are defined. Other states and events will most likely be associated with a producing I/O application object. 
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Acknowledge Handler Object, Class Code: 2Brex 


State > Non-Existent Inactive Active 
Events V 
Receive Acknowledge | Not Applicable Ignore Event Clear Ack Flag 
Forward any data to application object 
If all Acknowledges received 
Clear Ack Timer and Retry Counter 
Send Acknowledge_Received event 
message to producing application object 
Acknowlege Timer Not Applicable Ignore Event Send Ack_Timeout event message to 
Expires producing application object. 
Data Sent Not Applicable Ignore Event Set Ack Required Flag 
Set Ack Timer 
Clear Retry Counter 
Data Resent Not Applicable Ignore Event Set Ack Required Flag & Ack Timer 
If Retry_Limit > 0 
Increment Retry Counter 
If Retry Counter = Retry_Limit 
Send Rety_Limit_Reached event 
message to producing application object 
Delete Not Applicable Transition to Non-Existent Transition to Non-Existent 
Create Transition to Not Applicable Not Applicable 
Inactive 
Apply Attributes Not Applicable Verify new connection can be added to Verify new connection can be added to list. 
list. Pass this message to the consumed Pass this message to the consumed 
application object, if one is configured for | application object, if one is configured for 
this connection. this connection. 
Connection Not Applicable Add this connection instance to the Add this connection instance to the 
Transition to connection list (or internally flag as connection list. Pass this message to the 
Established ‘Acking’) . consumed application object, if one is 
Pass this message to the consumed configured for this connection. 
application object, if one is configured for 
this connection. 
Send Acknowledge_Active event message 
to producing application. 
Transition to Active. 
Inactivity/Watchdog | Not Applicable Not Applicable Internally flag this connection as ‘Not 
Timer Expires Acking’. An acknowlegement will no 
longer be monitored for this connection, 
however it remains in the connection list. 
Pass this event to the consumed application 
object, if one is configured for this 
connection. 
If no ‘Acking’ connections in list, send 
Acknowledge_Inactive event to producing 
application and transition to Inactive. 
Connection Deleted Not Applicable Ignore Event Remove this connection instance from the 


connection list. 

Pass this event to the consumed application 
object, if one is configure for this 
connection. 

If no ‘Acking’ connections in list, send 
Acknowledge_Inactive event to producing 
application and transition to Inactive. 
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5-32.1 


5-32.2 


Overload Object, Class Code: 2Cyex 


Overload Object 
Class Code: 2C hex 


This object models all the functions specific to an AC motor overload protection device. 


Class Attributes 


Table 5-32.1 Overload Object Class Attributes 


Attribute Need in Access Name Data Description of Attribute 
ID Implementation | Rule Type 


1 thru 7 These class attributes are optional and are described in Chapter 4 of this specification. 


Instance Attributes 


Table 5-32.2 Overload Object Instance Attributes 


Attribute Need in Access Name Data Description of Attribute 
ID Implementation | Rule Type 


1 Number of Attributes supported 
2 List of Attributes supported 
USINT 
3 Optional Set TripFLCSet INT Overload Full Load Current Setting 
Units : 100ma / 20""emSeale 
it. | where CurrentScale is attribute 12 
4 Optional Set TripClass USINT Trip Class Setting 
a a Ui Me 
5 Optional Get AvgCurrent INT Average of the three phase current. 
Units: 100ma / 2°0u"e"See 
r ae. eC where CurrentScale is attribute 12 


N 
Z 
eS 


Optional 


%Thermal USINT % Thermal Capacity 


Get CurrentLl INT Actual motor phase current L1 
Units: 100ma / 2°0u7e"Se* 
where CurrentScale is attribute 12 
Get CurrentL2 INT Actual motor phase current L2 
ae | Units: 100ma / 2°u"e"See 
where CurrentScale is attribute 12 
10 Optional Get CurrentL3 INT Actual motor phase current L3 
Units: 100ma / 2°u"e"See 
where CurrentScale is attribute 12 


oe) 


Optional 


9 Optional 


Ground Current 

Units: 100ma / 2 

where CurrentScale is attribute 12 
CurrentScale SINT Current scaling factor. Scaling is 
accomplished as follows: 
ScaledCurrent = 100ma / 2 
Range: -128 .. 127 


GroundCurrent 


11 Optional 


CurrentScale 


12 Optional 


CurrentScale 
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5-32.3 


5-32.4 


Overload Object, Class Code: 2Cyex 


Scaling of attribute values 


As part of the Overload object definition, a separate scaling factor is specified current. To 
maximize the resolution capable or necessary on some devices or applications, current values 
can be normalized using a binary scale factor before transmission on the bus. Normally, this 
scaling factor will normally be set up once during initialization depending on the range of 
current values to be used in the application. 


CurrentScale allow the representation of current on the bus to be kept as short as possible 
while still preserving an acceptable resolution and dynamic range for all applications. 


Example: 


Output (to device from bus): 


TripFLCSet(Overload Object, Attribute ID 3) = 23456 

CurrentScale (Overload Object, Attribute ID 12) = 8 

=> Actual FLC setting used by device = TripFLCSet = 23456 + 2°= 91.625 x 100mA = 
9.1625 amps 


Input (from drive to bus): 


Actual FLC setting used by device = 78.95 amps = 789.5 x 100mA 
CurrentScale (Overload Object, Attribute ID 12) = 3 
=> TripFLCSet(Overload Object, Attribute ID 3) = 789.5 x 2° = 6316 
Devices that do not support CurrentScale (Attributes 12), should return a zero, or not supported 


attribute error. In this case, the default scaling (0) is presumed. All currents will then default to 
units of 100ma. 


Common Services 


Table 5-32.3 Overload Object Common Services 


Need in 4 ee 4 
4 F Service Name Description of Service 
Service Implementation 


OEhex Get_Attributes_Single Returns the contents of the specified attribute. 
10hex n/a Set_Attributes_Single Modifies an attribute value. 


15hex n/a Optional | Restore Restores attribute values from a storage location 
accessible by the Save service. This service is only 
available if the drive is in the Ready_Disabled or 
Wait_Power states. 


16hex Optional | Save Saves all attribute values to a location accessible by 
the Restore service. 


See Appendix A for definition of these services 


Object-specific Services 


The Overload object provides no object specific services. 
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5-32.5 Behavior 


The Overload object behavior can be changed by setting attributes, overload current setting and 
Trip Class setting will effect the trip curve of the device. 
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5-33.2 


Softstart Object, Class Code: 2Dyex 


Softstart Object 
Class Code: 2D hex 


This object models all the functions specific to a Soft Start Motor Starter. 


Class Attributes 


Table 5-24.1 Softstart Object Class Attributes 


Attribute Need in Access Name Data Type Description of Attribute 
ID Implementation | Rule 


1thru 7 | These class attributes are optional and are described in Chapter 4 of this specification. 
Instance Attributes 
Table 5-24.2 Softstart Object Instance Attributes 


eee Need in Access Name Data Description of Attribute 
een Rule fone 


Optional Attributes Array esi] List of Attributes supported 
USINT 


Required AtReference BOOL Starting/stopping output voltage 
reference status 
0 = Not At Reference 
1 = Output At Voltage Reference 


Required Set StartMode USINT |0=No Voltage Ramp 

No Current Limit 

1 = Voltage Ramp 
No Current Limit 

2 = No Voltage Ramp 
Current Limit 

3 = Voltage Ramp 
Current Limit 

4-9 = Reserved by CIP 

10 — 255 = Vendor Specific 


5 Optional Set StopMode USINT | 0 = Coast 
1 = Ramp Down 
2 = Brake 
3 —9 = Reserved by CIP 
10 — 255 = Vendor Specific 
6 Optional Get/Set | RampMode BYTE 0 = Single Ramp 
1 = Dual Contiguous Ramp 
2 = Dual Independent Ramp 
3 —9 = Reserved by CIP 
10 — 255 = Vendor Specific 
7 Optional Get/Set | RampTime1 UINT Tenths of Seconds 
8 Optional Get/Set | Initial Voltage1 USINT  |0- 100 % Of Full Line Voltage 


10 InitialVoltage2__ | USINT _| 0 - 100 % of Full Line Voltage 
11 Optional Get/Set | Rotation BOOL | 0=ABC phase rotation 
1 = CBA phase rotation 
12 Optional Get/Set | KickStart BOOL se disabled 
= enabled fixed time 
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Attribute Need in Access Name Data Description of Attribute 
ID aE Rule Type 


13 KickStartTime _ |USINT | Tenths of Seconds 


15 Optional Get/Set | EnergySaver BOOL _ |0= disabled 
1 = enabled 


17 Optional Get/Set | CurrentLimitSet UINT Percent of Rated Current (Motor 
Data Instance Attribute 6) 
Percent of Rated Current (Motor 


18 Optional Get/Set | BrakingCurrentSet | UINT 
Data Instance Attribute 6) 


5-33.3 Common Services 


Table 5-24.3 Softstart Object Common Services 


Need in 
Re fe 


| Class_| | Instance | 


Get_Attributes_Single 


a Set_Attributes_Single 


i 


See Appendix A for definition of these services 


Service Name Description of Service 


Service 


Code 


Returns the contents of the specified 
attribute. 


Modifies an attribute value. 


Restores attribute values from a storage 
location accessible by the Save service. This 
service is only available if the drive is in the 
Ready_Disabled or Wait_Power states. 


ee ee all attribute values to a location 
ne: by the Restore service. 


5-33.4 Object-specific Services 


The Softstart object provides no object specific services. 


5-33.5 Behavior 


5-33.5.1 Starting Behavior 


The controlled starting of motors can be accomplished using one or more optional approaches; 
Voltage Ramp (single ramp, dual contiguous ramp, or dual independent ramp options), Current 
Limit, or a combination of Voltage Ramp /Current Limit. 


StartMode (Attribute 4) configures the device to Voltage Ramp / Current Limit starting 
behavior. 


5-33.5.1.1 Voltage Ramp Starting 


Voltage Ramp based starting (with no current limiting) is selected by setting the StartMode 
(Attribute 4) to a value of “1”. The mode in which the voltage is ramped up is selected by 
RampMode (Attribute 6). 
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5-33.5.2 
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When RampMode (Attribute 6) = 0, Single Ramp mode is selected. In this mode the output 
voltage of the Soft Starter is increased at a fixed rate, over a user defined time period, 
RampTimel (Attribute 7), until it reaches the full line voltage rating of the softstart. To over 
come motor/load inertia, the output voltage may be set to higher than zero voltage, 

Initial Voltage1 (Attribute 8) before the voltage ramp up is started. For very high load inertia 
situations, the full line voltage can be applied for a fixed period of time: KickStart (Attribute 
13) is set to 1, or optionally a user defined voltage (specified as a % of full line voltage) for a 
user defined period of time: Kick Start (Attribute 13) is set to 1, KickStartTime (Attribute 12) 
(greater than zero), and Kick Start Voltage (Attribute 18) (greater than zero) values are entered. 


When RampMode (Attribute 6) = 1, Dual Contiguous Ramp mode is selected. In this mode the 
output voltage is increased at a fixed rate, over a user defined time period, RampTime1 
(Attribute 7), until it reaches Initial Voltage2 (Attribute 10). The output voltage then increases 
at a different fixed rate, over a second user defined time period, RampTime2 (Attribute 9), until 
it reaches full line voltage. As in single ramp soft starters, the first ramp of a dual contiguous 
ramp soft starter may be preceded with Initial Voltage1 and/or Kick Start functions. 


When RampMode (Attribute 6) = 2, Dual Independent Ramp mode is selected. In this mode the 
user can use the Run1 (Control Supervisor Attribute 3) and Run2 (Control Supervisor 
Attribute 4) commands to alternate between 2 pre downloaded single ramp starting profiles. 
The use of the Run1 attribute, starts the motor using the RampTime1 and Initial Voltage1 
values. The use of the Run2 attribute, starts the motor based on the RampTime2 and 

Initial Voltage2 values. All other Output Configuration Attributes are common to both ramps, 
except for potential vendor specific settings of the StopMode (see Stopping Behavior section). 


Current Limit Starting 


Current Limit based starting (with no voltage ramp) is selected by setting the StartMode 
(Attribute 4) to a value of “2”. In this case the output voltage is increased until the motor 
current equals the CurrentLimitSet (Attribute 16). The voltage is then maintained at a level that 
does not allow the current Limit to be exceeded, until either full speed is reached (and motor 
current drops below the CurrentLimitSet) or until the overload is tripped. The Current Limit 
may only be exceeded during operation of the Kick Start function. CurrentLimitSet(Attribute 
16) is entered as a percent of the Motor Data Object Instance attribute RatedCurrent (Attribute 
6) value. 


Voltage Ramp With Current Limited Starting 


Voltage Ramp with Current Limit based starting is selected by setting StartMode (Attribute 4) 
to a value of “3”. In this case the output voltage increases according to the selected voltage 
ramp until the CurrentLimitSet (Attribute 16) is reached. At this point, the output voltage stops 
increasing and current limit based starting continues until either full speed is reached (and 
motor current drops below the CurrentLimitSet) or until the overload is tripped. 


CurrentLimitSet (Attribute 16) is entered as a percent of the Motor Data Object Instance 
attribute RatedCurrent (Attribute 6) value. 


Stopping Behavior 


Several optional Stop Modes; Coasting, Ramp Down, DC Braking, or Vendor Specific may be 
selected via StopMode (Attribute 5). The Stop Mode chosen is independent of the devices 
Start Mode setting. 
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5-33.5.2.3 


5-33.5.2.4 


5-33.5.3 
5-33.5.3.1 


5-33.5.3.2 


Softstart Object, Class Code: 2Dyex 


Coasting to Stop 


In this mode, the soft starter sets the output to zero volts, and the motor “coasts” to stop. 


Ramp to Stop 


In this mode, the output voltage is decreased at a fixed rate from line voltage to zero volts over 
the user defined time period Decel Time (Attribute 16). 


DC Brake to Stop 


For fast motor stopping, a DC braking current is applied to the motor for the duration of the 
DecelTime (Attribute 15). The amount of DC braking current applied to the motor is specified 
in BrakingCurrentSet (Attribute 17). BrakingCurrentSet (Attribute 17) is entered as a percent 
of the Motor Data Object Instance attribute RatedCurrent (Attribute 6) value. 


Vender Specific Stopping 
In this mode, the soft starter stops the motor by setting the output voltage according to a profile 


unique to a particular vendor. 


Other Attribute Behaviors 


Rotation (Attribute 11) 


Sets the main voltage phase rotation sequence for Phases A, B & C. 


EnergySaver (Attribute 14) 


Sets whether the energy saver function is active when the motor is operating at reference. The 
energy saving function works as follows: When a motor is operating under a loaded condition 
and then the load is reduced, the current the motor draws will decrease. The energy saver 
function lowers the voltage to a point where the current starts to increase again. The output 
voltage is maintained at that level until the load increases, in which case the soft starter will 
increase the output voltage back up to the line voltage level. 
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5-33.5.4 Soft Starter Output Voltage Behavior Description 


Figure 5-33.4 Example: Dual Contiguous Ramp Soft Start With Ramp Down Stop Mode 
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Figure 5-33.5 Example: Dual Independent Ramp Soft Start With Ramp Down Stop Mode 
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5-34 Selection Object 
Class Code: 2E hex 


The Selection Object manages the selection and distribution of data between objects. 
Revision History 


Table 5-34.1 Selection Object Revision History 


Revision Reason for object definition update 
01 Initial Release 
02 Modified for use as general data flow manager and added NV column to attribute table 


5-34.1 Class Attributes 


Table 5-34.2 Selection Object Class Attributes 
Number Need in Access | NV Name Data Description of Semantics of Values 
Implement Rule Type Attribute 
1 Conditional * | Get NV Revision |UINT | Revision of this The current value 
assigned to this attribute 
is two (2). 


These class attributes are optional and are described in Chapter 4 of this specification. 
8 Reserved for CIP 


9 Optional Get NV Max Indicates maximum | Range 0 — 65535. 
number of number of instances 
instances supported. 


*This attribute is REQUIRED if the application supports revision (2) of this object, otherwise the attribute is 
OPTIONAL. 


5-34.2 Class Services 


Table 5-34.3 Selection Object Class Services 


Service Need In Service Name Service Description 

O8hex Used to instantiate a next instance of the class. 

O9hex Used to delete all instances of class. 

O6hex Used to start all instances of class 

07hex Used to stop all instances of class. 

OShex Used to reset all instances of class. Clear table entries. 
OEhex Used to read a class attribute value. 


*This Service is REQUIRED if any Class attributes are supported. 


5-34.3 Instance Attributes 


Table 5-34.4 Selection Object Instance Attributes 


AttrID}| Needin |Access| NV | Attribute | Data Type | Attribute Description | Semantics of Values 


1 Required |Get |v [State ———[USINT State of the object. See attribute description. 
2 {Required Get INV |[Max_ UINT Indicates maximum Range 0-65535. 
destinations mumber of destination 0 = No destination 
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Attr ID} Needin |Access| NV | Attribute | Data Type | Attribute Description | Semantics of Values 
Implem Rule Name 


3 


an 


N 


10 


11 


12 


13 


14 


15 


16 


indexes supported. specified. 


Conditional |Get INV |Number_of_|JUINT Number of entries of {Range 0-65535. 
destinations destination_list. 


Array of List of destination paths [Path length, Path. See 
STRUCT of Appendix C for encoding. 


mii Se eeu 
ist 


{USINT Pathlength 
PATH) 


Required Get INV [Max_ UINT Indicates maximum Range 0-65535. 
Sources number of source l0 = No Source specified. 
indexes supported. 
Required Get INV |Number_of_|UINT Number of entries of = [Range 0-65535. 
Sources source_list. 
Conditional |Set INV |Source_list {Array of Array of consuming I/O |Connection Instance IDs. 
UINT Connection Instance 
IDs. 


Conditional |Get, INV |Source_used JUINT Index into source_list [Range 0-number of 
Set* array indicating which |sources, where one (1) is 
source is currently beingjfirst entry in source_list. 
used. 
Optional Get Source_ Array Indicates sources that |0 = Available, 
Alarm of lare not available. 1 = Not available, 
IBOOL Default values are all 0. 
Optional Get/Set INV [Algorithm_ [USINT The selection algorithm |If not supported, 
ype type. lalgorithm_type =0. 
Conditional |Get/Set INV |Detection_ |USINT Required when Range 2-255. Default 
Count lalogrithm type is alue is 4. 
supported. 
Conditional |Get/Set INV [Selection /UINT Required when Range 1-65535 
Period lalogrithm type is (ms). 
supported. 
Conditional |Set INV jobject_ ARRAY of {List of source paths Path length, 
source list |STURCT of 


{ USINT Pathlength 

PATH 
Set ia 
Conditional ma 


UINT Index into Range 0 to 
destination_list array | jnumber_of_destinations, 
indicating which here (1) is first entry in 
destination is currently |destination_list. 

See Behavior 
Set* 
Conditional ai 


la copy of the currently |See Device Profiles where 
* An application may restrict access to Get Only, generally based on the Algorithm types supported. 


selected source attribute jused for Restrictions on 
Data Type 


la copy of the currently |See Device Profiles where 
selected destination sed for Restrictions on 
attribute Data Type 


uo] 
c. 
ie} 
=} 
o 
—_ 


— 5-246 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 4 


5-34.4 


5-34.4.1 


5-34.4.2 


5-34.4.3 


5-34.4.4 


5-34.4.5 


5-34.4.6 


5-34.4.7 


5-34.4.8 
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Semantics 


State 


Defines the current state of the Selection Object instance. The table below defines the possible 
states and assigns a value used to indicate that state. 


Table 5-34.5 Values assigned to the state attribute 


Value Description 
00 The Selection Object does not exist. 
01 Idle The Selection Object does not distribute messages and the 
ee itl internal selection algorithm is not active. 
02 The Selection Object distributes messages and internal 
selection algorithm is running. 


max_destinations 


Maximum number of destination paths managed by the Selection Object. 


number_of_destinations 


Number of destination paths managed by the Selection Object. Default value is zero(0). This 
attribute is Required unless max_destinations = 0. 


destination_list 


This attribute is an array of paths to objects which receive messages from the Selection Object. 
See Volume I, Appendix C. All members in the list must be unique. This attribute is Required 
unless max_destinations = 0. 


max_sources 


Maximum number of source paths managed by the Selection Object. 


number_of_sources 


Number of source paths managed by the Selection Object. Default value is zero(0). The 
number_of_sources and number_of_destinations do NOT have to be equal. This attribute is 
Required unless max_sources = 0. 


source_list 


This attribute is an array of Consuming Connection Instance IDs which send messages to the 
Selection Object. All members in the list shall be unique. This attribute is Required unless (a) 
max_sources = 0, or (b) object_source_list is supported. 


source_used 


This attribute is used to indicate the source of a message which is selected by the Selection 
Object. The value of this attribute indicates the index into source_list currently in use. A value 
of zero (0) indicates no source is currently being used. 
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5-34.4.9 source_alarm 


This attribute is used to indicate which sources are available. Size of the array is equal to the 
value of the max_source attribute. 


5-34.4.10 algorithm_type 


Defines the algorithm types. If this attribute is supported and any value from 01 through 03 is 
supported, then support of all values, 00 through 03, is required. If values greater than 03 are 
supported, then support of the values 00 through 03 is optional. If this attribute is not 
supported, then all messages pass through. See table below. 


Table 5-35.6 Values assigned to the algorithm_type attribute 


Value State Name Description 
00 Pass Through All messages pass through. 
01 Hot Backup* Hot Backup is used as a selection algorithm. 
02 First Arrival* First Arrival is used as a selection algorithm. 


03 Last Arrival* Last Arrival is used as a selection algorithm. 

04 Programmable Data Flow Programmable Data Flow is used as a selection algorithm. 
05-63 Reserved Reserved for future use (Open). 

64-C7 Vendor Specific 


C8 -FF Reserved Reserved for future use. 


* If supported, then all values 00 through 03 shall be supported. 
5-34.4.11 detection_count 


The parameter used by algorithms, which require a counter. 


5-34.4.12 selection_period 


The parameter used by algorithms, which require a time interval. 


5-34.4.13 Object Source List 


This attribute is an array of paths from which data is sourced. This attribute is Required unless 
(a) max_sources = 0, or (b) source_list is supported. 


5-34.4.14 Destination Used 


This attribute is used to indicate the destination of data. The value of this attribute indicates an 
index into destination_list currently in use. A value of zero (0) indicates no destination is 
currently being used. 


5-34.4.15 Input Data Value 


This attribute contains the value retrieved from the Source. This attribute is Required only 
when max_sources = 0 
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5-34.4.16 Output Data Value 


This attribute contains the value being delivered to the Destination. This attribute is Required 
only when max_destinations = 0 


5-34.5 Instance Services 


Table 5-35.7 Selection Object Instance Services 


Service Need In Service Name Service Description 
Code Implementation 


OEhex Get_Attribute_Single Used to read a Selection Object attribute value. 
U 


10hex Set_Attribute_Single sed to modify a Selection Object attribute 
value. 


O6hex Used to start a Selection Object. 

O7hex Used to stop a Selection Object. 

OShex Used to reset a Selection Object. Clear paths. 
O9hex Used to delete a Selection Object. 

18 hex Used to get values of a member in an array. 
19 hex Used to set values to a member in an array. 
1A hex Used to insert or add a member to an array. 
1B hex Used to remove a member from an array. 


5-34.6 Instance Behavior 


The behavior of the Selection Object, while in the RUNNING state, is dependent upon the 
algorithm_type attribute. 


Figure 5-34.8 The Selection Object State Transition Diagram 


Non-existent 
Power Up AND 


No configuration 
Create OR Delete Delete 
Configuration Invalid 


Power Up AND 
Configuration Invalid 


Insert Member/ 
Remove Member/ 
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Table 5-34.9 State Event Matrix for Selection Object 


Class instantiates a 
Selection Object. 


Event 


Create 


Power Up & 


Configuration Valid 


Delete 


Start 


Stop 


Reset 


Receive_ Message 


Remove_ Member 


Insert_ Member 


Get_Attribute_Single 
Set_Attribute_Single 


Get_Member 
Set_Member 


Set default values. 
Transition to Idle. 


Transition to 
Running. 


Error: Object does 
not exist. 


Error: Object does 
not exist. 


Error: Object does 
not exist. 


Error: Object does 
not exist. 


Not applicable 


Error: Object does 
not exist. 


Error: Object does 
not exist. 


Error: Object does 
not exist. 


Not applicable. 


Not applicable. 


Release all associated 
resources. Transition to Non- 
existent. 


If attributes are valid, 
Transition to Running. 


Error: The object cannot 
perform the requested service 
in its current mode/state. 


Error: Set default values. 


Discard the message. 


Remove one member from 
source_list or destination_list 
attribute. Subtract one (1) 
from number_of_sources or 
number_of_ 


destinations attribute value. 


Insert or add one member to 
source_list or destination_list 
attribute. Algorithm type shall 
determine usage of members 
in array. 


Validate/service the request 
based on internal logic and 
per the Access Rules. 
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Running 


Not applicable. 


Not applicable. 


Release all associated 
resources. Transition to Non- 
existent. 


Error: The object cannot 
perform the requested service 
in its current mode/state. 


Transition to Idle. 


Discard all received messages. 
Set default values. Transition to 
Idle. 


When a message is received 
from a Connection Object, 
check source_list attribute and 
update source_used (if 
applicable). See algorithm_type 
for details. If fault detected, set 
appropriate source index bit in 
source_alarm attribute. 


Remove one member from 
source_list or destination_list 
attribute. Subtract one(1) from 
number_of_sources or 
number_of_destinations 
attribute value. 


Insert or add one member to 
destination_list attribute. Add 
one(1) to number_of_ 
destinations attribute value. 


A member cannot be added to 
source_list attribute. In this 
case, return error. 


Validate/service the request 
based on internal logic and per 
the Access Rules. 
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Table 5-34.10 Selection Object Attribute Access 


max_destinations Get only 
number_of_destinations Get only 
destination_list Get/Set/Insert/Remove 
number_of_sources Get only 

source_list Get/Set/Remove 
source_alarm Get only 
detection_count Get/Set 
selection_period Get/Set 


5-34.6.1 Message Distribution 


The Selection Object manages distribution of messages. This function provides multicast 
communication among Application Objects. The following diagram illustrates the message 
flow of this Multicast Communication. 


The Selection Object receives a message from a Connection Object and delivers this message 
to Application Object(s). 


Figure 5-34.11 I/O Message Distribution 
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5-34.6.2 Message Selection 


The Selection Object may produce one output message from multiple input messages. This 
function may be used for redundant node applications. The Selection Object selects one 
message from more than one message based on its internal algorithm. 


In high reliability systems, there is a requirement for redundant nodes. The Selection Object 
receives messages from redundant nodes and selects one message based on an internal selection 
algorithm. 


Figure 5-34.12 Message Selection Example 
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5-34.6.3 Message Selection Algorithms 
The following algorithms are currently defined for message selection. 


e Pass Through 
e Hot Backup 


e First Arrival 
e Last Arrival 
e Programmable Data Flow 


5-34.6.3.1 Pass Through 


No algorithm. Forward all arriving messages to destination(s). 
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5-34.6.3.2 Hot Backup 


This algorithm is shown in the Figure labeled Hot Backup. Node #1 is higher priority than 
Node #2. Node #3 normally accepts messages from Node #1. Node failure is detected in the 
following manner. If the Selection Object detects that Node #1 failed, it accepts messages from 
Node #2 and forwards them to Application Object(s). Upon the receipt of the message from 
Node #2, the “Message Counter” within the Selection Object is incremented by one. If the 
message from Node #1 is received, the “Message Counter” is reset. If the number of the 
“Message Counter” reaches detection_count (N), the Selection Object detects that Node #1 
failed. If Node #1 recovers and resumes sending messages, the Selection Object accepts 
messages from Node #1. “N” is the configurable maximum count and set in attribute 12. If 
“number_of_sources”, attribute 7, equals two(2) then the first member in the “source_list”, 
attribute 8, has the higher priority. 


Figure 5-34.13 Hot Backup 
Node 
#1 


--- Fault ---, -- Recovery 


#2 


#3 : 
peer 10 1-90 30 SH. Bate tN 0 0 0 fe. “ie 2G 
ounter 
X: Accept, - : Discard, Defbct 


N: detection_count 


5-34.6.3.3 First Arrival 


This algorithm is shown in the Figure labeled First Arrival. The Selection Object within Node 
#3 always accepts the first arriving message from either of the two nodes; Node #1 or Node #2. 
Upon receipt of the first message from an active node, the “Message Counter” within the 
Selection Object is incremented by one. The “Message Counter” is decremented each time a 
message is received from the alternate node. If the number within the “Message Counter” 
reaches “detection_count”, attribute 12, the Selection Object detects that a node failed. The 
node to which the positive count is associated determines the node from which the Selection 
Object forwards the message. “N” is the configurable maximum count contained within 
attribute 12. The “number_of_sources”, attribute 7, equals two(2). See the Figure labeled 
Behavior of First Arrival in “Running State” for detail behavior. 
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Figure 5-34.14 First Arrival 
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Figure 5-34.15 Behavior of First Arrival in “Running State” 
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5-34.6.3.5 
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Last Arrival 


This algorithm is shown in the Figure labeled Last Arrival. The Selection Object starts a timer 
when transmits to running. It forwards the last message received when the timer expires, and 
immediately restarts the timer. If no message is received AND the timer expires, the Selection 
Object does not forward a message to the Application Object(s). The “selection_period” which 
is shown as “dt” in the figure is the value contained in attribute 13. The “number_of_sources”, 
attribute 7, is equal to two(2) in the example. 


Figure 5-34.16 Last Arrival 
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Programmable Data Flow 


When selected, this algorithm affects the following object behavior: 


The Selection object uses the source-used attribute to select a Source EPATH from the 
object_source_list. This specifies the source from which the Selection object instance retrieves 
data values. Similarly, the destination_used attribute is used to select a Destination EPATH 
from the destination_list in order to specify the destination to which the Selection object 
instance delivers the retrieved data values. Optionally, (as specified by the application) the 
Selection object may perform some level of data type conversion. If this capability is specified 
by a Device Profile or Vendor, the extent to which it is supported shall be specified. The 
combined functions of Retrieval, Data Type Conversion and Delivery constitute the 
Application Process for the Selection object while executing the Programmable Data Flow 
algorithm. 


A source_used value of zero (0) halts the Retrieval portion of the Application Process. The 
retrieval and subsequent setting of the input_data_value is the only behavior effected by 
halting the Retrieval Application Process (i.e., source_used = 0). The input_data_value retains 
the last value set and is then accessible for manual (or I/O) setting. Similarly, a 
destination_used value of zero (0) halts the Delivery portion of the Application Process 
providing for manual (or I/O) setting of a referenced destination and making available for 
manual retrieval the output_data_value. With both the Retrieval and Delivery Processes 
halted, the object's Application Process consists only of the (optional) data conversion process, 
whereby, the output_data_value attribute is updated by the object based on the value of the 
input_data_value attribute. 
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Source EPATH 2 


Source EPATH n 


5-34.6.4 


Inactive 
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An attempt to set a member of the source_list or destination_list to a source or destination 
EPATH referencing a data type unsupported by the Selection object returns an Invalid 
Attribute Value error. Similarly, an attempt to set source_used and/or destination_used to an 
unsupported value will return an Invalid Attribute Value error; an attempt to set both such that 


an invalid combination results (i.e., non-matching data types) will return an Object State 
Conflict. 


An attempt to set a member of the object_source_list or destination_list attributes with an 


EPATH referencing an object class, instance, attribute or structure element that is not known or 
is not contained in the processing node returns a Path Destination Unknown error. 


Figure 5-34.17 Programmable Data Flow Example 
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Figure 5-34.18 I/O Message Distribution 
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Table 5-34.19 I/O Message Distribution Attribute Values 


Attribute Attribute Name Attribute Value 
Number 
state 02 


number_of_destinations 3 

destination_list {Path1, Path2, Path3} 
number_of_sources 01 

source_list {10} 

source_used 01 


source_alarm {0} 


OL MmIPnNn | ma] BR] we 


10 algorithm_type 00 
Table 5-34.20 I/O Message Selection Attribute Values 


Attribute Attribute Name Attribute Value 
Number 
state 02 


number_of_destinations 1 
destination_list {Path1} 
number_of_sources 02 
source_list {10,11} 
source_used 01 


source_alarm {0,0} 


OL aoOIrNy| ay, RR] wie 


10 algorithm_type 02 
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S-Device Supervisor Object 
Class Code: 30Hex 


This object models the interface, functions and behavior associated with the management of 
application objects for devices within the “Hierarchy of Semiconductor Equipment Devices”. 
Throughout this CIP Standard, objects belonging to this hierarchy are identified as such by a 
naming convention that includes a prefix of “S-” in the object class name. This “Hierarchy of 
Semiconductor Equipment Devices” is completely defined in this object definition such that all 
objects belonging to this hierarchy require the existence of an S-Device Supervisor object to 
manage its functions and behaviors. 


The S-Device Supervisor object centralizes application object state definitions and related 
status information, exception status indications (alarms and warnings), and defines a behavior 
model which is assumed by objects identified as belonging to the Hierarchy of Semiconductor 
Equipment Devices. That is, if a reset is requested of the S-Device Supervisor object instance, 
it will be performed by this object instance as well as all of its associated application objects. 


Similarly, the Identity object provides an interface to the S-Device Supervisor object. A reset 
request to the Identity object (of any type) causes a reset request to the S-Device Supervisor 
object. Further relationships are specified in the Behavior section below. 


Additionally, some device attributes are defined which are required in order to specify device 
models such that they are compliant with the SEMI S/A Network Standard ', from which the 
Hierarchy of Semiconductor Equipment Devices is derived. Objects defined to exist within the 
Hierarchy of Semiconductor Equipment Devices are done so in order to simplify the 
management and description of object behavior while insuring compliance with the SEMI 
Standard. 


NOTE: By association with this object, the Start, Stop, Reset, Abort, Recover and 
Perform_Diagnostic Services are inherently supported by all objects within the Hierarchy of 
Semiconductor Equipment Devices. Although, for the associated application object instances, 
these services are not accessible over the network. 


' Semiconductor Equipment and Materials International, Mountain View CA, Standard E54: Sensor/Actuator Network 
Common Device Model. 
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5-35.2 


S-Device Supervisor Object, Class Code: 30x 


Class Attributes 


Table 5-35.1 S-Device Supervisor Object Class Attributes 


Attribute Need in Access Name Data Type Description of Attribute 
ID implementation | Rule 


2 thru 7 These class attributes are optional and are described in Chapter 4 of this specification. 


Reserved by CIP for Future Use 


- 


* Tf the value of Subclass is 00 which identifies "no subclass", then this attribute is OPTIONAL in 
implementation, otherwise, this attribute is REQUIRED. 


Identifies a subset of additional 
class attributes, services and 
behaviors. 


Subclasses 


Each class level subclass defines a unique meaning for an overlapping range of class attribute 
IDs and/or class service IDs. The range for subclass definitions begins at ID 96 and numbers 
downward for attributes, and ID 63), and numbers downward for services. The subclass for a 
given class is identified by the value of its Subclass class attribute. The subclasses for this 
object are specified at the end of this object specification section. 


Instance Attributes 


CIP reserves Attribute ID 100-199 (6416,-C 7he,) for Vendor Defined Attributes. See Volume I, 
Chapter 4 for more information on Object Definitions. 


Table 5-35.2 S-Device Supervisor Object Instance Attributes 
Attr Need in Access Name Data Type Description of Semantics of 
ID _|Implementation| Rule Attribute Value 
1 {Optional NV |Number of Number of Attributes 
Attributes supported by the object 
instance 
2 |Optional NV |Attribute List Array of — |List of attributes 
USINT supported by the object 
instance 
3 Required V | Device Type SHORT  |ASCII Text, Max. 8 See “Semantics” 
STRING _ |Characters section 


4 |Required NV|SEMI Standard |SHORT [Specifies the revision |For this revision, 
Revision Level |STRING _ |level of the SEMI S/A_ this attribute 
Network Standard to _|must be: 
which the device “R54.0997” 
complies. 


5 Required NV |Manufacturer’s |SHORT  |ASCII Text, Max. 20 |See “Semantics” 
Name STRING — |Characters. section 
6 |Required Get |NV|Manufacturer’s ASCII Text, Max. 20 
Model Number |STRING  |Characters, 
Manufacturer Specified 
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Attr Need in Access |NV Name 
ID |Implementation| Rule 
7 Get |NV {Software 
Revision Level 
8 Get |NVJ|Hardware 
Revision Level 
9 {Optional Get |NV|Manufacturer’s 
Serial Number 
10 |Optional Get |N 
Configuration 
13 |Conditional Get V_ |Exception Detail 
based on Alarm 
Exception Status 
Bit 7 
Common 
Exception Detail 
Size 
Detail 
Detail n 
Device 
Exception Detail 
Size 
Conditional Detail 
based on Size 
Conditional Detail n 
based on Size 
Manufacturer 
Exception Detail 
Size 
Conditional Detail 
based on Size 
Conditional Detail n 
based on Size 
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Description of 
Attribute 
ASCII Text, Max. 6 


Characters 


ASCII Text, Max. 6 
Characters 


SHORT 
STRING 


SHORT 
STRING 


o 
= 
2 
4 
3 
oO 


SHORT ASCII Text, Max. 30 
STRING  |Characters, 

Manufacturer Specified 
SHORT ASCII Text, Max. 50 
STRING  |Characters, 


Manufacturer 
Specified. Optional 
additional information 
about the device 
configuration. 


BYTE 


STRUCT |A Structure of three 
Structures containing a 
bit mapped 


representation of the 
alarm detail 


clon ° Gq 

eee a 2 

Z a Z 

ie a) il 
el 


Number of Common 
Detail Bytes 
Number of Device 
Detail Bytes 


ARRAY 


fo) 
= 


= 
c| 
ie) 
Tl 


fo) 
= 


See Device Profile 


Semantics of 
Value 


> 


See “Semantics’ 
section 


> 


See “Semantics’ 
section 


> 


See “Semantics’ 
section 


> 


See “Semantics’ 
section 


> 


See “Semantics’ 
section 


> 


See “Semantics’ 
section 


> 


See “Semantics’ 
section 


See Device Profile 


Number of 


Manufacturer Detail 


Bytes 


ARRAY — |Manufacturer Specified 
Manufacturer Specified 


jo} jo} fo} 
ia 2 ia 2 
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Attr 
ID 


14 


15 


16 


S-Device Supervisor Object, Class Code: 30x 


Need in Access |NV Name Data Type Description of Semantics of 
Implementation} Rule Attribute Value 
Exception Detail |STRUCT A Structure of three 
of: Structures containing a 
bit mapped repre- 


sentation of the 
warning detail 


Conditional Get Vv 
based on 
Exception Status 
Bit 7 
Common STRUCT 
Exception Detail |of: 
Size USINT Number of Common 
Detail Bytes 
Detail ARRAY See “Semantics” 
of: section 
Detail n BYTE See “Semantics” 
section 


Device STRUCT 
Exception Detail |of: 
Size USINT Number of Device 
Detail Bytes 
Detail ARRAY {See Device Profile 
of: 
BYTE [See Device Profile 
Manufacturer STRUCT 
Exception Detail |of: 
Size USINT Number of 
Manufacturer Detail 
Bytes 
ARRAY — |Manufacturer Specified 
of: 


Detail n BYTE Manufacturer Specified 


Conditional 
based on Size 


Conditional 
based on Size 


Conditional 
based on Size 


Conditional 


based on Size 


Required Set |NVJ{Alarm Enable BOOL See “Semantics” 
section 

Required Set |NV]Warning Enable |BOOL See “Semantics” 
section 


Optional Set * |Time DATE_ The value of the See “Semantics” 
AND TIM device’s internal section 
E * realtime clock. 
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Access 


NV Name Data Type Description of Semantics of 
Rule Attribute Value 


18 |Optional Get |NV/Clock Power Describes the behavior |0 = [default] 
Cycle Behavior of the device’s internal |clock always 
realtime clock (the resets during 
Time attribute) during |power cycle 
a power cycle 


Attr Need in 
ID_ | Implementation 


1 = clock value 
is stored in non- 
volatile memory 
at power down 


2 = clock is 
battery-backed 
and runs without 
device power. 
3-255 = 
Reserved 


19 |Optional Get The date on which the 
device was last 


serviced. 


Last 
Maintenance 
Date 


20 |Optional Get Next Scheduled 
Maintenance 


Date 


DATE The date on which it is 
recommended that the 
device next be 


serviced. 


o CG 
ie 2 


21  |Optional Get Scheduled 


am 


NT See “Semantics” 
Maintenance section 
Expiration Timer 


See “Semantics” 


Maintenance section 


Required if 
Calibration Expiration 


Warning Enable 


23 |Optional Get 


V }Run Hours An indication of the 
number of hours that 
the device has had 
power applied. It has a 
resolution of 1 hour. 
This value shall be 
maintained in 
nonvolatile memory. 
24 Optional Get Endpoint Indicates that the 0 =Endpoint not 
device has determined |obtained 
that the conditions of |4 = Endpoint 
its endpoint algorithm | obtained 
are satisfied for a See Semantics 
particular recipe step. Cdeton. 


25 Optional Set Recipe eae a er See Semantics 
mechanism for ection 
selecting endpoint 
algorithms. 


22  |Conditional - Set [= 
Vv 
NV 


81-96 Defined by subclasses below 
97-98 Reserved by CIP for Future Use 
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5-35.3 


5-35.3.1 


5-35.3.2 


5-35.3.3 


5-35.3.4 


S-Device Supervisor Object, Class Code: 30x 
Attr Need in Access |NV Name Data Type Description of Semantics of 
ID |Implementation| Rule Attribute Value 


99 |Conditional ** Get |NV|Subclass UINT Identifies a subset of |0 = No subclass 
additional instance 1 = Power 
attributes, services and |Generator 
behaviors. 


* The nonvolatile behavior of the Time attribute is conditional on the value of the Clock Power Cycle Behavior 
attribute. 
** Tf the value of Subclass is 00, which identifies "no subclass" then this attribute is OPTIONAL in 
implementation, otherwise, this attribute is REQUIRED. 


Subclasses 


Each instance level subclass defines a unique meaning for an overlapping range of instance 
attribute IDs and/or instance service IDs. The range for subclass definitions begins at ID 96 
and numbers downward for attributes, and ID 63;., and numbers downward for services. The 
subclass for a given instance is identified by the value of its Subclass instance attribute. The 
subclasses for this object are specified at the end of this object specification section. 


Semantics 


Device Type 


The Device Type attribute, identifies the Specific Device Model to which the device is modeled 
within the Hierarchy of Semiconductor Equipment Devices. The value of this string is specified 
in the SEMI standard suite referenced in the introduction section of this object definition and is 
represented for reference in the applicable device profile where used. 


Manufacturer’s Name 


The Manufacturer’s Name attribute, identifies the manufacturer of the device. It is the 
responsibility of the manufacturer to insure that this ASCII coded text string is sufficiently long 
to insure uniqueness among manufacturers. 


The Device Manufacturer attribute is not guaranteed, by specification, to be unique. Therefore, 
it is not a substitute for the corresponding attribute of the Identity Object and should not be 
used for identification purposes. 


Software Revision Level 


This is an ASCII coded text string representing the revision of the software corresponding to 
the specific device identified by the Identity object and the S-Device Supervisor object. 


Hardware Revision Level 


This is an ASCII coded text string representing the revision of the hardware which is identified 
by the Identity object and the S-Device Supervisor object. The manufacturer of the device 
must control this revision such that modifications to the device hardware may be tracked. 
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5-35.3.6 


5-35.3.7 


S-Device Supervisor Object, Class Code: 30x 


Manufacturer’s Serial Number 


This attribute is a string representation of the vendor’s serial number of the device, formatted to 
fit most manufacturing tracking systems. This is not the same as the Identity Object’s serial 
number which is used to uniquely identify the device in the network environment. 


Device Status 


This attribute represents the current state of the device. Its value changes as the state of the 
device changes. The following values are defined: 


Table 5-35.3 Device Status Attribute Values 


Attribute Value State 
0 Undefined 
1 Self Testing 
2 Idle 
3 Self-Test Exception 
4 Executing 
5 Abort 
6 Critical Fault 
7-50 Reserved by CIP 
51-99 Device Specific 
100-255 Vendor Specific 


Exception Status 


A single byte attribute whose value indicates that the status of the alarms and warnings for the 
device. This indication may be provided in one of two methods: Basic or Expanded. 


For the Basic Method, bit seven of the Exception Status attribute is set to zero; all exceptions 
are reported exclusively through communication of this Exception Status attribute. The format 
of bits zero through six in this mode is device specific; the format may be further specified in 
an appropriate device profile specification; if it is not specified, then the format of bits zero 
through six is equivalent to that specified for the expanded method. 


For the Expanded Method, bit seven of Exception Status attribute is set to one; exceptions are 
reported through the communication of this Exception Status attribute, formatted as specified in 
the table below. In addition, the Exception Detail attributes are supported. The Exception 
Status bits are determined by a logical “OR” of the related Exception Detail bits, as indicated. 
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S-Device Supervisor Object, Class Code: 30x 


Table 5-35.4 Exception Status Bit Map 


Exception Status Bit Map, Bit 7 set to 0 Exception Status Bit Map, Bit 7 set to 1 


0 ALARM/device-common* 
1 ALARM/device-specific 
2 ALARM/manufacturer-specific 
Device Specific definition 
3 . ; reserved -- set to 0 
(See Device Profile) 
4 WARNING/device-common* 
5 WARNING/device-specific 
6 WARNING/manufacturer-specific 
7  |0== Basic Method 1 == Expanded Method 
* The alarm or warning is not specific to the device type or device type manufacturer. 


Exception Detail Alarm and Exception Detail Warning 


The formats of these two attributes are identical. Therefore, they are described together here: 


Attributes that relate the detailed status of the alarms or warnings associated with the device. 
Each attribute is a structure containing three members; these three members respectively relate 
the detailed status of exceptions that are common (i.e., not device-specific), device-specific but 
not manufacturer-specific, and manufacturer-specific. The common detail is defined below. 
The device-specific detail is defined in the appropriate Device Profile. The manufacturer- 
specific detail is defined by the manufacturer. A SIZE value of zero indicates that no detail is 
defined for the associated exception detail structure. 


Each of the three structure members is defined as a structure containing an ordered list (i.e., 
array) of bytes of length SIZE, and an unsigned integer whose value is SIZE. Each of the bytes 
in each array has a specific mapping. This mapping is formatted as 8 bits representing 8 
independent conditions, whereas a value of 1 indicates that the condition is set (or present), and 
a value of 0 indicates that the condition is cleared (or not present). Note that if a device does 
not support an exception detail, the corresponding bit is never set. The bitmaps for alarms and 
warnings in the corresponding attributes are structured in parallel so that a condition may have 
either alarm or warning set depending on severity. If a condition inherently cannot be both 
alarm and warning, then the parallel bit position corresponding to the other state will remain 
"0." 


The existence of an exception detail variable structure is dependent on the value of the 
Exception Status Attribute; the existence of an exception detail variable structure is only 
required if bit seven of the Exception Status attribute is set to 1 (indicating Expanded method 
reporting) and the bit (among bits zero through six) of the Exception Status attribute 
corresponding to the particular exception type is also set to 1. 
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5-35.3.10 


S-Device Supervisor Object, Class Code: 30x 


Common Exception Detail 


This structure relates exception conditions (i.e., alarms or warnings) which are common to all 
devices within the Hierarchy of Semiconductor Equipment Devices. The Detail element of the 
structure is an ordered list (i.e., array) of bytes of length [SIZE] which is the value of the 
structure element Size. For each byte in the Detail field, all bits which are not identified are 
reserved for future standardization. 


The first byte in this attribute is CommonExceptionDetail[0]. Additional exception details, if 
provided, are named CommonExceptionDetail[1], .... CommonExceptionDetail[SIZE]. The 
specific exception associated with each of the bitmaps is given in the table below. The SIZE 
for this revision is two (2). The criteria details for each exception condition are outside the 
scope of this document. 


Table 5-35.5 Common Exception Detail Attribute Values 


Bit Common Exception Detail [0]* Common Exception Detail [1]* 
0 Internal diagnostic exception power supply overcurrent 
1 Microprocessor exception reserved power supply 
2 EPROM exception power supply output voltage 
3 EEPROM exception power supply input voltage 
4 RAM exception scheduled maintenance due 
5 Reserved by CIP notify manufacturer 
6 Internal real-time exception reset exception 
7 Reserved by CIP reserved by CIP 


* Note that if a device does not support an exception detail, the corresponding bit is never set 


Device Exception Detail 


This structure, similar in form to Common Exception Detail, relates exception conditions, 
which are specific to individual devices on the network and are defined in their respective 
device profiles. The Detail element of the structure is an ordered list (i.e., array) of bytes of 
length [SIZE], which is the value of the structure element size. For a detailed description of 
this attribute, consult the appropriate specific device profile. 
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5-35.3.11 Manufacturer Exception Detail 


This structure, similar in form to Common Exception Detail, relates exception conditions, 
which are specific to the manufacturers of individual devices on the network and are defined by 
them in their product documentation. The Detail element of the structure is an ordered list (i.e., 
array) of bytes of length [SIZE], which is the value of the structure element Size. Fora 
detailed description of this attribute, consult the appropriate specific device manufacturer 
documentation. 


Table 5-35.6 Exception Detail Format Summary 


Detail 0 


Data Bit 7 Bit5 Bit 3 Bit 2 Bit 1 Bit 0 
Component 
Common 1 0 
Exception 
Detail Size 
Common Reserved | Real-time | Reserved Data Non- Micro- | Diagnostic 
Exception Memory | Volatile processor 


Common Reserved Notify | Scheduled} PS Input | PS Output | Reserved | PS Over 
Exception Exception | Vendor Maint. Voltage Voltage Current 
Detail 1 


Device x x x 


Device 
Exception 
Detail 0 


Detail Size 

Device 

Exception 

Detail n 

Manufacturer x x x 
Exception 
Detail Size 


Manufacturer 
Exception 
Detail 0 


Manufacturer | 


Exception 
Detail n 


These Boolean attributes are used to enable (1) or disable (0) the S-Device Supervisor object’s 
process of setting Exception bits. When disabled, corresponding bits are never set; and, if they 
were set, disabling clears them. Also, alarm and warning states are not retained; when enabled, 
bits will be set only if the corresponding condition is true. 


5-35.3.12 Alarm Enable and Warning Enable 


The default state for these Enable attributes is enabled (1). 
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5-35.3.14 


5-35.3.15 


5-35.3.16 


5-35.3.17 


S-Device Supervisor Object, Class Code: 30x 
Time 


This optional attribute represents the value of the time and date as maintained by the device’s 
realtime clock with a resolution of one millisecond. 


The default value for the Time attribute is zero (0), corresponding to 12:00AM, January 1, 
1972, as specified by Appendix C. 


Scheduled Maintenance Expiration Timer 


This attribute, with a resolution of one hour, is used to cause a warning which indicates that a 
device calibration is due. A S-Device Supervisor timer decrements this attribute once per hour 
while power is applied. When the attribute is no longer positive and the Scheduled 
Maintenance Expiration Warning Enable attribute is set to enabled, a Scheduled Maintenance 
Expiration Warning condition is generated. This causes the Scheduled Maintenance Due 
Warning bit to be set. 


The attribute will not wrap; when the attribute reaches its most negative value, it no longer 
decrements. The attribute will continue to decrement irrespective of the state of the Scheduled 
Maintenance Expiration Warning Enable attribute. The value shall be maintained in 
nonvolatile memory. 


Scheduled Maintenance Expiration Warning Enable 


This Boolean attribute is used to enable (1) or disable (0) the S-Device Supervisor object’s 
process of setting the Scheduled Maintenance Due Exception bit. When disabled, the 
corresponding bit is never set; and, if it was set, disabling clears it. When enabled, the bit will 
be set only if the corresponding condition is true. 


The default state for this Enable attribute is enabled (1). 


Endpoint 


This attribute is used to indicate that the device has determined that the conditions of its 
endpoint algorithm are satisfied for a particular recipe step. The vendor must specify the 
endpoint algorithm, including the configuration mechanisms and parameters. 


Recipe 


This attribute provides a common mechanism for selecting endpoint algorithms. This index 
pointer is used to specify which endpoint algorithm is currently active. The particular algorithm 
with its associated configuration, limits and other parameters are manufacturer specific. 
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5-35.4 Common Services 


Table 5-35.7 S-Device Supervisor Object Common Services 


Service Need in Implementation Service Name Description of Service 


OEhex Get_Attributes_Single Returns the contents of the specified 
attribute. 


10hex Set_Attributes_Single Modifies an attribute value. 

OS5hex n/a Required Reset Resets the device to the Self-Testing 
state. 

O6hex n/a Required Start Starts the device execution by moving 
the device to the Executing state. 
Equivalent to SEMI S/A Network 
Execute Service 


See Appendix A for definition of these services 
5-35.5 Object-specific Services 


Table 5-35.8 S-Device Supervisor Object Object-specific Services 


Service Need in Implementation Service Name Description of Service 
Code Class Instance 


4Bhex Moves the device to the Abort state 


state 
4Ehex n/a Required Perform_Diagnostics Causes the device to perform a set of 
diagnostic routines 


Table 5-35. 9 DS Object Service Parameter Dictionary 


Parameter Description of Service 


TestID USINT Type and possibly detail of diagnostic test to be performed 


5-35.5.1 Abort 


Used to transition the device application objects to the aborted state. This service request may 
be (and generally will be) originated internally, from application objects. 


5-35.5.2 Recover 


Used to transition the device application objects, out of the abort state, to the idle state. This 
service request may be originated internally, from application objects. 
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5-35.5.4 


5-35.6 


5-35.6.1 


S-Device Supervisor Object, Class Code: 30x 


Perform_Diagnostics 


Used to instruct the S-Device Supervisor object to perform a diagnostic test. A diagnostic test 
is either of type common or device-dependent. Common diagnostic tests could include: RAM, 
EPROM, non-volatile memory, and communications. The structure of common type diagnostic 
tests are implementation-specific. All detail of device-dependent diagnostics is outside the 
scope of this document. 


TestID Parameter 


The following values are defined for the TestID parameter for the Perform_Diagnostics Service 
Request: 


Table 5-35. 10 TestID Parameter Attribute Value 


Attribute Value State 
0 Standard 
1-63 Reserved 
64-127 Device Specific (defined in Device Profile) 
128-255 Manufacturer Specific (defined by manufacturer) 


Type “Standard” is specified if there is only one type of diagnostic defined or if there are more 
than one including a type standard. Additional diagnostic types may be defined in the device 
profile or by the manufacturer. 


Behavior 


S-Device Supervisor Object States 


Figure 5-35.11 DS Object Instance Behavior 


Power Applied, or 
Reset Request from any state except CRITICAL FAULT, or 
Perform Diagnostics Request from any state except CRITICAL FAULT or ABORT 


Self- Self-Test Failed , Self-Test 
Testing Recover Request or Exception 
Exception Condition 


Cleared 
Self-Test 
Abort Request 


v 
Idle Abort Request > Abort 
@ecover Request 
Critical 

Stop Request or Start Request or Fault 
1/O ConnectionTim¢out Receipt of First 

or I/O Connection Valid I/O Data 

Deleted Abort Request 


Executing 


Critical Fault 
from any state 
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Table 5-35.12 DS Instance Behavior State Description 


State Description 


EXECUTING | Device is executing, e.g., it is performing its device specific function. A detailed description of 
this state is outside the scope of this document. This state may be further specified in an 
appropriate device profile specification. 


SELF Object instance exists and has been initialized; all attributes have appropriate initial values (as 

TESTING indicated herein and in applicable device profile specification). Exception Status bits have been 
reset. Device is performing device-specific and device type specific test to determine if it is 
qualified to execute its application process. 


SELF TEST Object has detected an exception condition during self-testing. The details of the exception are 
EXCEPTION | stored in the appropriate attribute values of the S-Device Supervisor object. 


IDLE Object and device have been initialized and successfully completed self-testing. Further, the 
device is not executing the operational components of its device specific functions. 

ABORT Object instance is in an aborted state; a detailed description of this state is outside the scope of 
this specification. 

CRITICAL The object (and device) are in a fault state from which there is no recovery. object services 

FAULT cannot be processed. The conditions required for exit from a critical fault is outside the scope of 


this specification. 


The S-Device Supervisor Status attribute value indicates the state of the S-Device Supervisor 
object. It is updated on appropriate state transitions within the S-Device Supervisor object. 
Attribute values 1 through 6 represent valid states. A value of zero indicates that the S-Device 
Supervisor state is unknown; conditions under which a zero value may occur are outside the 
scope of this document. 
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5-35.6.2 State Event Matrix 


Table 5-35.13 State Event Matrix for S-Device Supervisor Object 


State 
Self-Testing Self-Test Executing Abort Critical Fault 
Event Exception (Recoverable Fault) 
Power Default Entry Point: — == Transition to 
Applied Device performs its Self- SELF-TESTING 


Test Application Process 


Self-Test Not Transition to IDLE Not Not Not Not 
Passed Applicable Applicable Applicable Applicable Applicable 
Not ot 


Self-Test 
Failed 


Not 
Applicable 


Set appropriate N Not 
Exception Status Bits | Applicable Applicable 


and Transition to SELF- 
TEST EXCEPTION 
Exception Set appropriate Not Not 
Condition Exception Status | Applicable Applicable 
Cleared Bits and 
Transition to 
SELF-TESTING 
Critical Fault |Transitionto |Transition to CRITICAL | Transition to Transition to Transition to Ignore Event 
CRITICAL CRITICAL CRITICAL CRITICAL FAULT 
FAULT FAULT FAULT 
Reset Transition Restart SELF-TESTING | Transition to Transition to Transition to SELF- Ignore Event 
Request SELF- SELF-TESTING |SELF-TESTING |TESTING 


TESTING 


Start Request |Transition to | Error OSC* Error OSC* Error AIRS* Error OSC* Ignore Event 
EXECUTING 
Stop Request |Error AIRS* | Error OSC* Error OSC* Transition to Error OSC* Ignore Event 
IDLE 

Abort Transition to | Transition to ABORT Error OSC* Transition to Error AIRS* Ignore Event 
Request ABORT ABORT 

Recover Error OSC* Restart SELF-TESTING | Transition to Error OSC* Transition to IDLE Ignore Event 
Request SELF-TESTING 


Perform Transition to | Restart SELF-TESTING |Transition to Transition to Perform all device Ignore Event 
Diagnostics SELF-TESTING |SELF-TESTING |diagnostics test. 
Request 


VO Ignore Event |Ignore Event Ignore Event Transition to Ignore Event Ignore Event 
Connection IDLE 

Timeout 

Receipt of Transition to |Ignore Event Ignore Event Normal Response |Ignore Event Ignore Event 
First Valid = |EXECUTING 

1/O Data 


VO Ignore Event |Ignore Event Ignore Event Transition to Ignore Event Ignore Event 
Connection IDLE 
Deleted 


* Error AIRS = Error Response “Already in Requested Mode/State” (Code OBnex) 
Error OSC = Error Response “Object State Conflict” (Code 0C,,.x) 


Any S-Device Supervisor instance service may be requested internally by the device as 
specified by the manufacturer. Generally, these requests will be generated as the result of an 
event such as the activation of a button or external contact closure. 
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5-35.6.3. S-Device Supervisor and Identity Object Interface 


The following two tables describe the effects that the Identity object and the S-Device 
Supervisor object have on each other based on events. This event mapping defines the interface 
between these two objects. 


Table 5-35.14 Effect of Identity Object Event 


Identity Object Event S-Device Supervisor Object Affected Event 
Power Applied Power Applied 
Failed Tests Self-Test Failed 
Passed Tests Self-Test Passed 
Major Unrecoverable Fault Critical Fault 
Minor Fault No effect 
Fault Corrected Exception Condition Cleared 
Reset Reset Request * 


* The S-Device Supervisor object service requests are generated by the device in response to these events. 


Table 5-35.15 Effect of S-Device Supervisor Object Event 


S-Device Supervisor Object Event Identity Object Affected Event 
Power Applied Power Applied 
Self-Test Passed Passed Tests 
Self-Test Failed Failed Tests 
Exception Condition Cleared Fault Corrected 
Critical Fault Major Unrecoverable Fault 
Perform Diagnostics Request No effect. * 


* The request to perform diagnostics has no effect on the Identity Object. However, the results of the tests may. 


5-35.6.4 S-Device Supervisor and Application Object Interface 


When processing Stop, Start, Reset, Abort, Recover and Perform_Diagnostics service requests, 
the S-Device Supervisor object coordinates all Application Objects within the device, as 
appropriate, in order that they will exhibit behavior consistent with the S-Device Supervisor 
object instance state. 


This object interfacing is best described in the SEMI standard suite as referenced in the 
introduction section of the object definition. 


5-35.7. S-Device Supervisor Instance Subclass 01 — Power Generator 


The following specification applies to a subclass of this object for application in Power 
Generator devices such as those used to create plasma energy. 
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Instance Attributes 


The following Instance Attributes are specified for this object subclass. 


Table 5-35.16 Power Generator Instance Attributes 


Attr Need in Access | NV Name Data Type Description of | Semantics of Values 
ID |Implementation} Rule Attribute 
81 Conditional* Set | NV |Energy Control]BOOL Controls the Energy |0 = Disabled [default] 
Control Application |1 = Enabled 
Process (See 
Behavior) 
82 Conditional* Set | NV |Joules to Controls the Energy |Joules 
Deliver Control Application [default] = 0 
Process (See 
Behavior) 
83 Conditional* Get Vv Controls the Energy |Joules 
Control Application [default] = 0 
Process (See 
Behavior) 
84 Optional** Set | NV A numerical index [default] = 0 
ID referring to which 
target is being 
tracked via the 
Active Target Life 
Accumulator 
85 Optional** Set | NV |Active Target Enables the Active |[default] = 0 
Life Counter Target Life counter 
Enable 
86 Optional** Set | NV |Active Target Once set, the value }|KWH 
counts down to [default] = 0 
zero. Upon reaching 
a zero count, the 
associated 
Exception Detail 
Warning bit is set. 
87 Optional Get | Nv |Input Power |UDINT Factory reset Seconds 
On Time accumulator 
88 Optional Get | Nv |Output Power Factory reset Seconds 
On Time accumulator 
89 Optional Set | Nv |Filament On Settable Seconds 
Time accumulator [default] = 0 
90 Optional Get | NV |Total Energy |U Factory reset KWH 
Delivered accumulator 
91 Optional Get | Nv |Power On UDINT Factory reset Counts 
Cycle Counter accumulator 
92 Optional Get Nv |Output On UDINT Factory reset Counts 
Cycle Counter accumulator 
93 Optional Get Nv |Device Over- |UDINT Factory reset Counts 
temp Event accumulator 
Counter 
94 Optional Get Nv |Regulation UDINT Factory reset Counts 
Alarm Event accumulator 
Counter 
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Attr Need in Access | NV Name Data Type Description of | Semantics of Values 
ID | Implementation} Rule Attribute 


95 Optional Set vy |Filament Causes the filament |0 = Disables Power 
Power Enable power to turn only |[default] 
if the device is in 1 = Enables Power 
the Executing state 
96 Required Set y_ |Output Power Causes the power _|0 = Disables Power 
Enable output to turn on [default] 
only if the device is 1 = Enables Power 
in the Executing 
state 


* Required if Energy Control is supported 
** Required if Target Life tracking is supported 


5-35.7.2 Services 


There are no additional services defined for this subclass 


5-35.7.3. Behavior 
5-35.7.3.1 Energy Control Application Process 


The Energy Control Application Process makes use of a down counter. When power delivery 
is started, the Joules Remaining attribute assumes the value of the Joules to Deliver attribute. 
While power is being delivered, the Energy Accumulator calculates delivered energy and 
decrements the Joules Remaining attribute accordingly. Upon reaching a value of zero, the 
power delivery is stopped. 
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5-36 S-Analog Sensor Object 
Class Code: 31hex 


The S-Analog Sensor Object models the acquisition of a reading from a physical sensor in a 
device. Associated with an analog sensor is a reading that has been acquired and corrected 
with an offset and a gain coefficient, optionally, settable in the object. Additional correction 
algorithms may be specified by other objects identified in the device profile or as extensions 
specified by the manufacturer. 


This object is a member of the Hierarchy of Semiconductor Equipment Devices. As such, its 
behavior is managed by the S-Device Supervisor Object. See Section 5-35. 


5-36.1 Class Attributes 


Table 5-36.1 S-Analog Sensor Object Class Attributes 


Attr ID Need in Access Name Data Description of Semantics of Value 
Implementation | Rule Type Attribute 


1 thru 7 | These class attributes are optional and are described in Chapter 4 of this specification. 


32 Condtional ** Get Class USINT 
Level 
Status 
Extension 


Indicates whether a } Bit 0: Reading Invalid 
combination or Bit 1: Overrange Exceeded 
multigauge 
measures above or 
below its 
maximum or 
minimum 
measurement range 


Bit 2: Underrange Exceeded 


94-96 | Defined by Subclasses 
97-98 | Reserved by CIP for Future Use 


99 Conditional * Get Subclass |UINT | Identifies a subset |0= No subclass 
of additional class | 1 = Instance Selector 
attributes, services 
ante bahar: 2 - 65535 = Reserved by CIP 


* Tf the value of Subclass is 00, which identifies "no subclass", then this attribute is OPTIONAL in 
implementation, otherwise, this attribute is REQUIRED. 


** Required for combination gauges and multigauges only 


5-36.1.1 Subclasses 


Each class level subclass defines a unique meaning for an overlapping range of class attribute 
IDs and/or class service IDs. The range for subclass definitions begins at ID 96 and numbers 
downward for attributes, and ID 63), and numbers downward for services. The subclass for a 
given class is identified by the value of its Subclass class attribute. The subclasses for this 
object are specified at the end of this object specification section. 


5-36.2 Instance Attributes 


Certain minimal implementations may support any optional “Set” attributes as “Get Only” and 
still be compliant with this object specification. All required attributes must be supported as 
specified. 
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Table 5-36.2 S-Analog Sensor Object Instance Attributes 


Attr 
ID 


1 


10 


11 


Need in Access | NV Name Data Type Description of |Semantics of Values 
Implementation] Rule Attribute 
Optional Get NV |Number of USINT Number of 
Attributes attributes 
supported 
Optional Get NV {Attribute List |ARRAY OF List of attributes 
USINT supported by this 
object instance 
Optional See NV |Data Type USINT Determines the see Semantics 
Semantic Data Type of section 
S Value and all 
related attributes 
as specified in this 
table. 
Optional See NV |Data Units ENGUNITS Determines the see Semantics 
Semantic Units context of — |section 
S Value and all 
related attributes. 
Required Get V_ |Reading Valid |BOOL Indicates that the |0 = invalid 
Value attribute 1 = valid 
contains a valid __| (invalid: e.g., not 
value. warmed up yet) 
Required Get V_ {Value INT or Analog input The corrected, 
specified by value converted, calibrated 
Data Type if final value of the 
supported sensor. 
see Semantics 
section 
Required Get V_ {Status Alarm and see Semantics 
Warning State of {section 
this object 
instance 
Optional Set NV |Alarm Enable Enables the setting }0 = disable [default] 
of the Alarm 1 = enable 
Status Bits 
Optional Set NV |Warning Enables the setting }0 = disable [default] 
Enable of the Warning 1 = enable 
Status Bits 
Optional Get NV |Full Scale INT or The Value of Full |The value of 
specified by Scale for the attribute Value 
sensor. corresponding to the 
Full Scale calibrated 
measurement of the 
sensor. 
[default] = maximum 
allowable value for 
the Data Type 
Optional Get NV |Offset-A Data Determines the see Semantics 
Data Type of section 
attribute Offset-A 
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ne Need in Access Name Data Type Description of |Semantics of Values 
Een Rule Attribute 


. mal 7 

13 |Required if NV |Gain Data 
Attribute “Gain” Type 

Ee 
Required if 
Attribute “Gain” 


is other than 
REAL 


is other than 
REAL 


Gain 


V |Unity Gain 
Reference 


Offset-B 


Alarm Trip 
Point High 


Alarm Trip 
Point Low 


Alarm 
Hysteresis 


Alarm Settling 
Time 


Warning Trip 
Point High 
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INT or 
specified by 
Offset-A Data 
Type if 
supported 


An amount added |see Semantics 
prior to Gain to section 
derive Value = [default] 


see Semantics 
section 


Determines the 
Data Type of 
attribute Gain 


REAL or 
specified by 
Gain Data Type 
if supported 


REAL or 
specified by 
Gain Data Type 
if supported 


see Semantics 
section 


0 = [default] 


An amount scaled 
to derive Value 


Specifies the value 
of the Gain 
attribute 
equivalent to a 
gain of 1.0 


Used for normalizing 
the Gain attribute. 


[default] = 1.0 


e.g., for an UINT 
type Gain, a Unity 
Gain Reference may 
be 10000, allowing a 
gain of 0.0001 to 
6.5535. 


see Semantics 
section 


= [default] 


An amount added 
to derive Value 


INT or 
specified by 


INT or 
specified by 


see Semantics 
section 

[default] = 
Maximum value for 
its data type. 

see Semantics 
section 

[default] = Minimum 
value for its data 
type. 

see Semantics 
section 

[default] = 0 


Determines the 
Value above 
which an Alarm 
Condition will 
occur 
Determines the 
Value below 
which an Alarm 
Condition will 
occur 
Determines the 
amount by which 
the Value must 
recover to clear an 
Alarm Condition 
Determines the 
time that the 
Value must exceed 
the Trip Point 
before the 
exception 
condition is 
generated. 
Determines the 
Value above 
which a Warning 
Condition will 
occur 


Time in milliseconds 
see Semantics 
section 

[default] = 0 


INT or 
specified by 


see Semantics 
section 

[default] = 
Maximum value for 
its data type. 
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Attr 


ID 
22 


23 


N 
Ss 


25 


26 


27 


28 


29 


30 


31 


32 
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Need in Access Name Data Type Description of |Semantics of Values 
——e Rule Attribute 
Optional Ee Warning Trip Determines the see Semantics 
Point Low Value below section 
which a Warning |[default] = Minimum 
Condition will value for its data 
occur type. 
Optional V |Warning Determines the see Semantics 
Hysteresis amount by which |section 
the Value must [default] = 0 
recover to clear a 
Warning 
Condition 
Optional V |Warning Determines the Time in milliseconds 
Settling Time time that the see Semantics 
Value must exceed |section 
the Trip Point [default] = 0 
before the 
exception 
condition is 
generated. 
Optional Safe State Specifies the see Semantics 
behavior for the _|section 
Value for states [default] = 0 
other than Execute 
Optional Safe Value The Value tobe |see Semantics 
used for Safe State |section 
= Safe Value [default] = 0 
Optional Autozero Enables the see Semantics 
Enable Autozero section 
0 = disable [default] 
1 = enable 
Optional Autozero Indicates the see Semantics 
Status status of the section 
automatic nulling |[default] = 0 
Optional V |Autorange Enables the see Semantics 
Enable automatic range _|section 
switching 0 = disable [default] 
1 = enable 
Optional Range Indicates the see Semantics 
Multiplier current range section 
multiplier [default] = 1.0 
Optional V |Averaging Specifies the time |Time in Milliseconds 
Time over which analog }of a moving-window 
samples are average. 
averaged. 0 = disable 
averaging [default] 
Values less than the 
sample rate of the 
device also disable 
averaging. 
Optional NV |Overrange Specifies the The value above 
specified by highest valid which attribute 
Data Type if Value Reading Valid is set 
supported to invalid. 
[default] = maximum 
allowable value for 
the Data Type 
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Attr Need in Access Name Data Type Description of |Semantics of Values 
ID | Implementation} Rule Attribute 


33 |Optional Get NV |Underrange INT or Specifies the The value below 
specified by lowest valid Value | which attribute 
Data Type if Reading Valid is set 
supported to invalid. 
[default] = minimum 
allowable value for 
the Data Type 
34 |Optional Set NV |Produce INT or The amount by 0 = Disabled 
Trigger Delta |specified by which Value must |[default] 
Data Type if change beforea |See Semantics 


Calibration Indicates which 0 = Disabled 
Object Calibration object |[default] 
Instance instance is active |See Semantics 
for this object section 
Specifies the Type |0 = [default] 
for Produce See Semantics 
Trigger Delta section 


supported Change of State _|section 
and/or Produce |Production is 
: 


Trigger Delta _|triggered 


79- |Defined by Subclasses below 


Produce 
Trigger Delta 


Type 


97- |Reserved by CIP for Future Use 


SHORT A user defined Maximum of 20 
STRING ASCII value used |characters 
to identify the 
sensed parameter 
99 | Conditional ** Get NV |Subclass UINT Identifies a subset |0 = No subclass 
of additional |1= Flow 
instance attributes, | Diagnostics 
services and _|2 = Heat Transfer 
behaviors. Vacuum Gauge 
3 = Capacitance 
Manometer 
4 = Cold Cathode 
Ion Gauge 
5 = Hot Cathode Ion 
Gauge 
6 = Transfer 
Function 
7-65535=Reserved 
by CIP 
* See Semantics section. 


** Tf the value of Subclass is 00, then this attribute is OPTIONAL in implementation, otherwise, this attribute is 
REQUIRED. 


Subclasses 


Each instance level subclass defines a unique meaning for an overlapping range of instance 
attribute IDs and/or instance service IDs. The range for subclass definitions begins at ID 96 
and numbers downward for attributes, and ID 63),., and numbers downward for services. The 
subclass for a given instance is identified by the value of its Subclass instance attribute. The 
subclasses for this object are specified at the end of this object specification section. 
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5-36.3.1 


5-36.3.2 


5-36.3.3 


5-36.3.4 


S-Analog Sensor Object, Class Code: 31 4x 
Semantics 


Data Type 


All Data Type attributes, including Data Type, Offset-A Data Type and Gain Data Type, use 
the enumerated values specified in Appendix C-6.1. 


The Data Type attribute is settable only in the Idle State and only if no attribute belonging to 
the object instance is the endpoint of an I/O connection in the Established State. 


The Data Type attribute may change automatically based upon established I/O connections. See 
Behavior section for more information on this mechanism. 


Data Units 


Specifies the context of Value and related attributes (such as, offset and trip points) for this 
object instance. See Appendix D for a list of values. A request to set attribute to an unsupported 
value will return an error response. 


The Data Units attribute is settable only in the Idle State. 


Value, Offset (A and B) and Gain 


An S-Analog Sensor object instance derives a reading from a physical analog sensor. The 
reading is converted to the data type and units specified for the Value attribute. The Offset-A, 
Offset-B and Gain attributes are applied to the sensor reading as specified by the following 
formula: 


Value = Gain e ( Sensor Reading + Offset-A ) + Offset-B 


Typically, the Offset-A or Offset-B attributes are modified by the Zero-Adjust service and the 
Gain attribute is modified by the Gain_Adjust services; particularly, when the device utilizes a 
non-linear conversion algorithm. However, support of these services is not required. See 
Behavior section. 


Status 


A bit mapped byte which indicates the Alarm and Warning Exception status of the object 
instance. The following definition applies: 


Table 5-36.3 Status Attribute Bit Definitions 


Bit Definition 

0 High Alarm Exception: 0 = cleared; 1 = set 

1 Low Alarm Exception: 0 = cleared; 1 = set 

2 High Warning Exception: 0 = cleared; 1 = set 
3 Low Warning Exception: 0 = cleared; 1 = set 
4 Reserved 

5 Reserved 

6 Reserved 

7 Reserved 
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5-36.3.7 


5-36.3.8 
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Trip Points, Hysteresis and Settling Time 


Trip Point High is the level above which the Value attribute will cause an Alarm or Warning 
exception condition. 


Trip Point Low is the level below which the Value attribute will cause an Alarm or Warning 
exception condition. 


A Hysteresis value specifies the amount by which the Value attribute must transition in order to 
clear an Alarm or Warning condition. For example: A Trip Point High value of 100 anda 
hysteresis value of 2 will result in an exception condition being set when the Value is above 
100 and cleared when the Value drops below 98. Similarly, A Trip Point Low value of 100 and 
a hysteresis value of 2 will result in an exception condition being set when the Value is below 
100 and cleared when the Value increases above 102. 


The Settling Time determines the amount of time that the Value attribute must exceed the Trip 
Point before the exception condition is generated. The Settling Time also applies to the 
clearing of the condition. 


Safe State 


This attribute specifies what value will be held in Value for states other than Executing. See 
the S-Device Supervisor object definition in Section 5-35. for a description of object states. 
The purpose of this mechanism is to allow other devices, that may be using this Value, to 
transition to, or remain in, a safe state in the event of this device transitioning to a FAULT, 
IDLE, or ABORT state. The following values are defined: 


Table 5-36.4 Safe State Attribute Values 


Attribute Value State 

0 Zero 
1 Full Scale 
2 Hold Last Value 
3 Use Safe Value 
4 Continue Sensing 

5-50 Reserved 

51-99 Device Specific 

100-255 Vendor Specific 
Safe Value 


For Safe State set to Use Safe Value, this attribute holds the value to which the Value attribute 
will be set for object instance states other than Executing. 


Autozero Enable and Autozero Status 


When the autozero is enabled, the device will automatically invoke a Zero_Adjust service 
request (no parameter) contingent upon a set of conditions specified by the manufacturer. 
These conditions may be determined by the value of an attribute (e.g., setpoint) or some other 
mechanism defined by the manufacturer. See Zero_Adjust service. 
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5-36.3.11 
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While the device is in the process of nulling due to an Autozero event, the value of Autozero 
Status is one (1). When the device is not in the process of nulling, this value is zero (0). 


Autorange Enable and Range Multiplier 


When the autorange is enabled, the device will automatically switch full-scale range based on a 
set of conditions specified by the manufacturer. The Range Multiplier indicates the range 
scale. 


An example of how Autorange may work is: when the Value is less than 9% with a Range 
Multiplier of 1.0, the Range Multiplier switches to 10.0 (the Value then reads 90% of the 10X 
range). When the Value then reaches 100% with a Range Multiplier of 10.0, the Range 
Multiplier returns to 1.0 (the Value then reads 10% of the 1X range). 


Produce Trigger Delta 


This attribute is used in conjunction with the "Change of State" production trigger type. Upon 
transition of the associated connection object instance (any Change of State connection 
pointing to the S-Analog Sensor object Value attribute) to the established state, a production is 
immediately triggered and this reported Value is stored internally for the determination of the 
next production trigger. When the Value changes by an amount of at least the Produce Trigger 
Delta (i.e., the Value as compared to the internally stored previously produced Value), a new 
production is triggered, and this reported Value becomes the new internally stored Value for 
the determination of the next production trigger. The interpretation of this attribute is absolute 
value unless otherwise specified by the Produce Trigger Delta Type attribute. 


Calibration Object Instance 


This attribute is used to select an instance of the S-Gas Calibration object or the S-Sensor 
Calibration object as specified by the device profile where this object is used. The selected S- 
Calibration object instance provides the data with which an S-Analog Sensor object instance 
enacts the appropriate calibration algorithm for a given gas type, material type or other 
parameter dependency that might affect a sensor’s calibration. 


A Set_Attribute_Single request, specifying a value not supported, will return an “invalid 
attribute value” error response. A list of acceptable values for this attribute is derived from a 
class level service request to the Calibration object. 


* Conditionally Required: If a device profile specifies a Calibration object relationship for an 
S-Analog Sensor object instance, then this attribute is required. See the S-Gas Calibration 
object or the S-Sensor Calibration object definition for more information. 
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5-36.3.12 Produce Trigger Delta Type 


The Produce Trigger Delta Type attribute specifies the interpretation of the Produce Trigger 
Delta attribute. The following values are defined: 


Table 5-36.5 Produced Trigger Delta Type Attribute Values 


Produce Trigger Delta Type Produce Trigger Delta Type | Produce Trigger Delta Data Type 


Attribute Value 
0 [default] As Specified by Data Type 
1 UINT 
2-255 Reserved by CIP for Future Use 


Due to the logarithmic, or other non-linear nature of some analog measurements, the data units 
of the Produce Trigger Delta attribute may be set to a Percent Produce Trigger Delta. This 
also causes the Data Type of Produce Trigger Delta to be type UINT with a resolution of 
0.1%. 


For example, if the last COS-produced reading was 5E-5, the Produce Delta Trigger Type was 
set to 1 (Percent), and the Produce Trigger Delta = 200 (which equates to a delta of 20%), then 
the next reading will be produced at 4E-5 or 6E-5. 


5-36.3.13 Value Descriptor 


The Value Descriptor attribute identifies the Value of the S-Analog Sensor Object. It describes 
the physical meaning of the value the sensor delivers, e.g.: ion current, electron density or 
intensity of one wavelength of an optical emission spectrum. 


5-36.4 Common Services 
The S-Analog Sensor Object provides the following Common Services: 


Table 5-36.6 S-Analog Sensor Object Common Services 


Service | Need in Implementation Service Name Description of Service 
OEhex Get_Attribute_Single | Returns the contents of the specified 
attribute. 


Olnex Set_Attribute_Single Modifies an attribute value. 


*The Get_Attribute_Single service is REQUIRED if any attributes are implemented. 


See Appendix A for definition of these services 
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Object-specific Services 
The S-Analog Sensor Object provides the following Object-Specific Services: 


Table 5-36.7 S-Analog Sensor Object Object-specific Services 


Service Need in Implementation Service Name Description of Service 


n/a Optional Zero_Adjust Causes the device to modify attribute Offset-A 
and/or Offset-B such that attribute Value equals 


the Target Value sent with the request. 


4Bhex 


Gain_Adjust Causes the device to modify attribute Gain, such 
that attribute Value, equals the Target Value sent 


with the request. 


4Chex Optional 


Zero_Adjust and Gain_Adjust Services 


The Zero_Adjust and Gain_Adjust services are used to cause the S-Analog Sensor Object 
device to modify its Offset-A and/or Offset-B and Gain attribute values based upon 
manufacturer specific algorithms. The target value specified in the service request represents 
the actual parametric measurement that the physical sensor should be reporting at the time of 
the request. 


There are no state transitions associated with the invocation of these services. It is, therefore, 
incumbent upon the user to establish the device into the desired configuration prior to, and 
during, the execution of these services. This will generally involve exposing the sensor to a 
known environment and treating the values read during execution of the services accordingly. 


A success service response indicates that the service was accepted and the application process 
started. 


Table 5-36.8 Zero_Adjust Request Service Data Field Parameters 


Target Optional Specified by the The target value The value to which the Value attribute 
Value value of attribute for the zero will be set. If not specified, the default 
Data Type calibration value of zero is used. 


Table 5-36.9 Gain_Adjust Request Service Data Field Parameters 


Target Required Specified by the The target value The value to which the Value attribute 
Value value of attribute for the gain will be set. 
Data Type calibration 


Behavior 


The behavior of this object is managed by the S-Device Supervisor Object in Section 5-35.5. 
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An S-Analog Sensor object instance acquires a reading from a physical sensor, as identified by 
the application of the object, and applies an algorithm to modify the reading into the 
appropriate Date Type and Data Units. Optionally, additional corrective algorithms are applied 
to further correct for various calibration effects. These additional algorithms are specified in 
other objects, as identified in the device profile, or as extensions, specified by the 
manufacturer. 


All Full Scale, Trip Point, Overrange and Underrange calculations, as specified above, utilize 
the Value attribute. 


Data Type 


If the implementation of this object specifies more than one valid Data Type value, in the 
device profile or by vendor, then the following behavior with respect to Data Type applies: 
The Data Type value will be set automatically based upon the first valid I/O connection 
established by the device. If, however, a device is specified by a vendor to support only one 
Data Type, this behavior is not supported. 


If no established I/O connections exist, which include an attribute from this object, then the 
Data Type attribute is settable provided that the object is in the Idle State. The following 
example demonstrates this behavior: 


A device profile specifies an instance of the S-Analog Sensor object as well as two static 
Assembly object instances, both with data attribute components mapped to this object instance. 
Assembly object instance ID 1 specifies INT data types and Assembly object instance ID 2 
specifies REAL data types. 


After the device is On-Line, it is configured with an I/O connection to Assembly instance ID 2. 
When the connection transitions to the Established State, this object instance attribute Data 
Type is automatically set with the value for REAL before any data is communicated to, or 
from, the object instance. Any subsequent attempt to connect to Assembly instance ID 1 would 
then be rejected and result in an INVALID ATTRIBUTE VALUE error with the additional 
error code indicating the ID of the offending attribute, which in this case would be the 
connection path. 
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S-Analog Sensor Object Class Subclass 01 (Instance Selector) 

The following is a class-level subclass extension to the S-Analog Sensor Object. It provides a 
single port mechanism for flowing data from the active S-Analog Sensor Instance and allowing 
that the Active Instance ID may change. The intended application is for Gauge Controllers 
where more than one gauge is connected, but only one gauge is considered the "active" gauge. 


Class Attributes 


The following Class Attributes are specified for this object subclass. 


Table 5-36.10 Instance Selector Subclass Class Attributes 


Attr Need in Access| NV | Name Data Type Description of Attribute | Semantics 
ID_ | Implementation | Rule of Values 


94 Optional Get Vv INT or specified } Can be used by assemblies to 
by Data Type produce this class-level 
(Instance Attribute | attribute, instead of the Value 
ID 3) if supported (Attribute ID 6) of the S- 
Analog Sensor Instances. 


95 Optional Get Vv Active Identifies the object instance | Default = 1 
Instance that is providing the Value 
Number which is copied into the 
Active Value for all input 
Assemblies and the 
Alarm/Warning Exception 
Details for the S-Device 
Supervisor object. 
See Behavior section. 


96 Optional Get NV | Number Identifies the number of default = 
of Gauges gauge instances present in the [gauge- 
device. specific] 


Semantics 


Active Value 


Assemblies or connections may produce this class-level attribute, instead of the Value 
(Attribute ID 6) of the active S-Analog Sensor instance. The S-Analog Sensor class-level 
attribute Active Instance Number identifies the object instance that is currently active and 
providing the Value to the Active Value class-level attribute which is, in turn, produced by the 
input assemblies that have Active Value as a member. 


Active Instance Number 


The device internally modifies this attribute, as required, to identify the S-Analog Sensor object 
instance providing the Value member which is copied into the Active Value for all Input 
Assemblies and the Alarm/Warning Exception Details for the S-Device Supervisor object. 


See Behavior for more information on the mechanism. 
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S-Analog Sensor Object, Class Code: 31 4x 


Number of Gauges 


This attribute is used to determine the size of all Input Assemblies within a node. See the 
respective Device Profile for its usage within a Device Type. 


Services 


There are no additions or restrictions to the Object Services for this object subclass. 


Behavior 


The specific algorithm used to set the Active Instance Number is manufacturer specific. 
However, most will follow the basic logic that each of multiple gauges are valid (or ideally 
suited) for specific ranges of measurement. Therefore, the Active Instance Number will be 
modified based upon the Active Value in order that the best gauge, corresponding to a given S- 
Analog Sensor instance, will be active for the given measurement range. 
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S-Analog Sensor Object Instance Subclass 01 (Flow Diagnostics) 


The following specification applies to a subclass of this object for application in Mass Flow 
Controller devices. 


Instance Attributes 


The following Instance Attributes are specified for this object subclass. 


Table 5-36.11 Flow Diagnostics Subclass Instance Attributes 


Attr Need in Access | NV Name Data Description of Attribute |Semantics of Values 
ID | Implementation | Rule Type 
95 


Optional Set NV_ |Flow ULINT Total gas flowed through the | Units are Standard CCs 
Totalizer device since this value was last }see Behavior section 
set to zero default = 0 
96 |Optional Set NV_|Flow Hours }|UDINT Total time device has been Resolution is one hour 
powered and flowing gas since | see Behavior section 
this value was last set to zero | default = 0 


Services 


There are no additions or restrictions to the Object Services for this object subclass. 


Behavior 


Flow Totalizer and Flow Hours Process 


The factory configured out-of-box values for the Flow Totalizer and Flow Hours attributes are 
both zero. The attributes are only modifiable with set_attribute_single service requests; they 
are not altered by the Reset service, including power-cycle, of either the Identity or the S- 
Device Supervisor objects. 


The Flow Totalizer attribute is incremented, at a rate of once every cubic centimeter of gas 
flow, by the S-Analog Sensor object instance to reflect the amount of gas that has flowed 
through the device. Upon reaching its maximum value, the Flow Totalizer value is no longer 
incremented and remains at its maximum value. 


The Flow Hours attribute is incremented, at a rate of once every hour, by the S-Analog Sensor 
object instance to reflect the amount of time that gas has flowed through the device. This 
condition is determined by the Value attribute being greater than 0.5% of full scale. Upon 
reaching its maximum value, the Flow Hours value is no longer incremented and remains at its 
maximum value. 
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5-36.9 


5-36.9.1 


5-36.9.2 
5-36.9.2.1 


5-36.9.2.2 
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S-Analog Sensor Object Instance Subclass 02 (Heat Transfer Vacuum 
Gauge) 


Following is a subclass extension to the S-Analog Sensor Object. The original usage for the 
subclass is for Heat Transfer Vacuum Gauges. The Heat Transfer Vacuum Gauge extension is 
used in conjunction with the Vacuum/Pressure Gauge Profile providing control and status 
information unique to heat transfer gauges - Convection, Pirani and Thermocouple gauge types. 


Instance Attributes 


Certain minimal implementations may support any optional ”Set” attributes as ”Get” only and 
still be compliant with this object specification. Although no attribute is individually required, 
this object requires that one or more attributes be used. 


Table 5-36.12 Heat Transfer Vacuum Gauge Subclass Instance Attributes 
Attr Need in Access | NV Name Data Type Description of Semantics of 
ID | Implementation | Rule Attribute Values 
91 |Optional Set NV |Cable Length UINT ransducer cable length |[default = 0] 
for compensation, if Units in cm 
required see Semantics 
92 | Optional Set NV | Sensor High REAL Maximum [default = 0] 
Temp Warning compensatable Sensor | Units in °C 
Value Temperature. 
| ales 
EE 
et 
Get 


V_|Sensor Warning |STRUCT of | Bit definitions of [default=0] 
BYTE Sensor Warning see Semantics 
BYTE 
95 | Optional V_ | Sensor Alarm STRUCT of | Bit definitions of [default=0] 
BYTE Sensor Alarms see Semantics 
BYTE 
96 |Optional V_ {Status Extension |BYTE Bit-mapped byte [default=0] 
providing additional see Semantics 
status bits of an S- 
Analog Sensor instance. 


Semantics 


93 | Optional G V_ | Sensor REAL Sensor temperature in | see Semantics 
Temperature 2G, 
: : 


Cable Length 
This attribute specifies the cable length of the transducer cable (cable between the sensor 
[filament] and its electronic). 

Sensor Temperature 


Ambient temperature of the sensor housing. This value could be used for temperature 
compensation. 
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5-36.9.2.3 Sensor Warning 


The Sensor Warning attribute provides 16 bits for the current Sensor Warning state of the 
object. The Sensor Warning attribute also maps to the S-Device Supervisor Exception Detail 
Warning attribute. The following table provides definitions for each Sensor Warning bit. 
Reserved bits must be set to zero. 


Table 5-36.13 Sensor Warning Attribute 


Data Bit 7 Bit 5 Bit 3 Bit 2 Bit 1 Bit 0 
Component 
Byte 0 


Sensor Warning High Low Reserved | Reserved | Reserved | Sensor High | Electronics | Reserved 
Byte 1 Warning | Warning Temperature | Warning 
Exception | Exception Warning 


5-36.9.2.4 Sensor Alarm 


The Sensor Alarm attribute provides 16 bits for the current Sensor Alarm state of the object. 
The Sensor Alarm attribute also maps to the S-Device Supervisor Exception 

Detail Alarm attribute. The following table provides definitions for each Sensor Alarm 

bit. Reserved bits must be set to zero. 


Table 5-36.14 Sensor Alarm Attribute 


Data Bit 7 Bit 5 Bit 3 Bit 2 Bit 1 Bit 0 
Component 


Sensor Alarm | Reserved | Reserved | Reserved | Reserved | Reserved} Reserved Reserved Sensor 

Byte 0 Element 

Failure 

Sensor Alarm Reserved | Reserved | Reserved Over Electronics | Reserved 
Byte 1 Temperature Failure 


Exception | Exception of 
Electronics 


5-36.9.2.5 Status Extension 


8 Bits providing the current sensor alarm state of the object. 


Table 5-36.15 Status Extension Attribute 


Reserved | Reserved | Reserved | Reserved | Reserved | Underrange | Overrange} Reading 
Exceeded | Exceeded | Invalid* 


* Note: Logical inversion of Reading Valid 


5-36.9.3 Services 


There are no additions or restrictions to the Object Services for this object subclass. 


5-36.9.4 Behavior 


There are no additions or restrictions to the Object Behavior for this object subclass. 
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5-36.10 S-Analog Sensor Object Instance Subclass 03 (Diaphragm Gauge) 
Following is a subclass extension to the S-Analog Sensor Object. The original usage for the 


subclass is for Diaphragm Gauge Gauges. The Diaphragm Gauge extension is used in 
conjunction with the Vacuum/Pressure Gauge Profile providing control and status information. 


5-36.10.1 Instance Attributes 


Certain minimal implementations may support any optional ”Set” attributes as ”Get” only and 
still be compliant with this object specification. Although no attribute is individually required, 
this object requires that one or more attributes be used. 


Table 5-36.16 Diaphragm Gauge Subclass Instance Attributes 
ID_| Implementation | Rule Attribute Values 
93 |Optional Set NV |Sensor REAL The temperature in degrees Celsius 
Temperature Celsius at which the [default] = 
sensor has warmed up. |vendor specific 
94 |Optional Get V_ |Sensor STRUCT of |Bit definitions of [default=0] 
Warning BYTE Sensor Warnings See Semantics 
BYTE 
95 |Optional Get V {Sensor Alarm|STRUCT of |Bit definitions of [default=0] 
BYTE Sensor Alarms See Semantics 
BYTE 
96 |Optional Get V |Status BYTE Bit mapped byte (default=0] 
Extension providing additional See Semantics 
status of an S-Analog 
Sensor instance. 
5-36.10.2.1 Sensor Warning 


5-36.10.2 Semantics 
The Sensor Warning attribute provides 16 bits for the current Sensor Warning state of the 
object. The Sensor Warning attribute also maps to the S-Device Supervisor Exception Detail 
Warning attribute as specified in the Vacuum/Pressure Gauge device profile. The following 
table provides definitions for each Sensor Warning bit. Reserved bits must be set to zero. 


Table 5-36.17 Sensor Warning Attribute 


DataComponent| Bit? | wité | its | pita | wits | wir | pier | Bito 
Sensor Warning | Reserved | Reserved | Reserved | Reserved | Reserved | Reserved | Reserved Not At 
Electronics 
Warning 


Sensor Warning High Low Reserved | Reserved | Reserved | Reserved Reserved 
Byte 1 Warning | Warning 
Exception | Exception 
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5-36.10.2.2 


5-36.10.2.3 


5-36.10.3 


5-36.10.4 
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Sensor Alarm 


The Sensor Alarm attribute provides 16 bits for the current Sensor Alarm state of the object. 
The Sensor Alarm attribute also maps to the S-Device Supervisor Exception Detail Alarm 


attribute as specified in the Vacuum/Pressure Gauge device profile. The following table 


provides definitions for each Sensor Alarm bit. Reserved bits must be set to zero. 
Table 5-36.18 Sensor Alarm Attribute 


Data 


Bit 7 Bit 5 Bit 3 Bit 2 Bit 1 
Component 
Byte 0 


Sensor Alarm Reserved | Reserved | Reserved Over Electronics 
Byte 1 Temperature Failure 
Exception | Exception of 
Electronics 


Status Extension 


8 Bits providing the current sensor alarm state of the object. 


Table 5-36.19 Status Extension Attribute 


Reserved | Reserved | Reserved | Reserved | Reserved | Underrange | Overrange} Reading 
Exceeded | Exceeded | Invalid* 


* Note: Logical inversion of Reading Valid 


Services 


There are no additions or restrictions to the Object Services for this object subclass. 


Behavior 


Bit 0 


Diaphragm 


Failure 
Reserved 


For heated sensors, the Sensor Temperature attribute indicates the temperature at which the 
sensor has warmed up. Once the sensor has ”warmed up”, the Reading Valid attribute of the S- 
Analog Sensor Object will be allowed to be set to TRUE provided that all other conditions 
governing its behavior are also met. The warning bit in the Sensor Warning attribute for Not At 


Temperature shall be cleared. 


— 5-294 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 5 


S-Analog Sensor Object, Class Code: 314¢x 


5-36.11 S-Analog Sensor Object Instance Subclass 04 (Cold Cathode Ion 
Gauge) 
Following is a subclass extension to the S-Analog Sensor Object. The original usage for the 
subclass is for Cold Cathode Ion Vacuum Gauges. The Cold Cathode Ion Vacuum Gauge 
extension is used in conjunction with the Vacuum/Pressure Gauge Profile providing control 
and status information. 
A Cold Cathode Ion Vacuum Gauge is a device that measures pressure at vacuum levels. At 
low pressures the operating of these gauges depends upon the establishment of a gas discharge 


between two metal electrodes by the application of a sufficiently high d.c. voltage. The gas 
discharge current is pressure dependent. 


5-36.11.1 Instance Attributes 


Certain minimal implementations may support any optional ”Set” attributes as ”Get” 
only and still be compliant with this object specification. 


Table 5-36.20 Cold Cathode Ion Guage Subclass Instance Attributes 
Implementation | Rule Attribute Values 
91 Optional Set V_ |High Voltage |REAL High voltage Volts 
applied to the [default] = 
anode. vendor specific 
92 Optional Set NV |Sensitivity REAL Conversion Factor }[default] = 1.0 
from current ratio |see Semantics 
to pressure section 
93 Required Get V_ |High Voltage /BOOL Indicates whether 0 = Off [default] 
Status the high voltage is |1=On 
turned on or off. 
94 Optional Get V_ {Sensor STRUCT of |Bit definitions of [default=0] 
Warning BYTE Sensor Warnings __|see Semantics 
BYTE 
95 Optional Get V_ {Sensor Alarm |STRUCT of |Bit definitions of [default=0] 
BYTE Sensor Alarms see Semantics 
BYTE 


96 Optional Status BYTE Bit mapped byte [default=0] 
Extension providing see Semantics 
additional status of 
an S-Analog Sensor 
instance 
5-36.11.2.1 High Voltage 


5-36.11.2 Semantics: 
Valid values for the High Voltage attribute are manufacturer specific. Attempts to set the High 
Voltage to an invalid value shall return the Invalid Attribute Value error response. 


5-36.11.2.2 Sensitivity 


The conversion factor used to convert the ratio of gauge currents to pressure. This conversion is 
manufacturer specific. 
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5-36.11.2.3 Sensor Warning 


The Sensor Warning attribute provides 16 bits for the current Sensor Warning state of the 
object. The Sensor Warning attribute also maps to the S-Device Supervisor Exception Detail 
Warning attribute as specified in the Vacuum/Pressure Gauge device profile. The following 
table provides definitions for each Sensor Warning bit. Reserved bits must be set to zero. 


Table 5-36.21 Sensor Warning Attribute 


mo 
Component 

Sensor Reserved | Reserved | Reserved ee Reserved Reserved Reserved | Reserved 
Warning 

Byte 0 


Sensor High Low Reserved a Overpressure Electronics | Reserved 
Warning Warning | Warning High Voltage ae Warning 
Byte 1 Exception } Exception Off Detected 


5-36.11.2.4 Sensor Alarm 


The Sensor Alarm attribute provides 16 bits for the current Sensor Alarm state of the object. 
The Sensor Alarm attribute also maps to the S-Device Supervisor Exception Detail Alarm 
attribute as specified in the Vacuum/Pressure Gauge device profile. The following table 
provides definitions for each Sensor Alarm bit. Reserved bits must be set to zero. 


Table 5-36.22 Sensor Alarm Attribute 


Data pi | 7 Bit 5 Bit 3 Bit 2 Bien 1 Bit 0 
gta | BT 
Sensor Reserved | Reserved | Reserved | Reserved Reserved Reserved Reserved | Reserved 
Alarm Byte 
0 


Sensor i Reserved | Reserved | Overpressure | Over Electronics | Reserved 
Alarm Byte High Voltage | Temperature Failure 
1 Exception | Exception Off of 
Electronics 


5-36.11.2.5 Status Extension 


8 Bits providing the current sensor alarm state of the object. 


Table 5-36.23 Status Extension Attribute 


Bit 7 Bit 0 
Reserved | Reserved | Reserved Reserved Reserved | Underrange | Overrange | Reading 
Exceeded | Exceeded Invalid* 


* Note: Logical inversion of Reading Valid 


5-36.11.3 Services 


The following instance-level services are defined for this subclass of the S-Analog Sensor 
object: 
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Table 5-36.24 Cold Cathode Ion Gauge Subclass Instance Services 


Service Need in Implementation Service Name Description of Service 


62hex n/a Conditional * | Set High Voltage State | Sets the high voltage to the state 
specified by the High Voltage 
State parameter. 
63nex n/a Conditional * | Clear Overpressure Clears the Overpressure High 
High Voltage Off Voltage Off bit after an automatic 
Alarm high voltage off 


* Required for single gauges only, otherwise support is optional 


5-36.11.3.1 Clear Overpressure High Voltage Off Alarm Service 


If the high voltage is switched off automatically in case of an overpressure condition, it is not 
possible to switch on the high voltage again before the Overpressure High Voltage Off bit is 
reset. This service attempts to reset the Overpressure High Voltage Off bit. See the State Event 
Matrix below. 

5-36.11.3.2 Set High Voltage State Service 
Attempts to set the high voltage to the state specified by the HighVoltageState parameter. This 
service may fail depending upon the current object state. See the State Event Matrix below. 


Table 5-36.25 Set High Voltage State Service Data Field Parameters 
Parameter Semantics of Values 
HighVoltageState Required BOOL See 0 = switches high voltage OFF 
Behavior 1 = switches high voltage ON 


5-36.11.4 Behavior 


5-36.11.4.1 | Alarms/Warnings 


If any bit of the attribute ’Sensor Alarm” is set, the high voltage is switched off automatically. 


5-36.11.4.2 No ignition detection 


The “No Ignition Detected” bit in the Sensor Warning attribute will be set under the following 
conditions: 


e The discharge is undetectable during normal operation. 


e Ignition is not detected following an Explicit request to set the High Voltage ON attribute 
to On. 


These conditions are likely to arise when the gauge is operating at very low pressures. 
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Figure 5-36.26 S-Analog Sensor Object Instance Behavior 


Sensor Alarm Detected 
(Overtemperature or elctronics 
failure) 


High Voltage 
Off 


Clear Overpressure 
High Voltage Off 
Alarm Request 


(Success) Clear Overpressure 
Set High Voltage State High Voltage Off 
ON Recnest (ances) Set High Voltage State Sensor Alarm an 
Off Request (Success) High Voltage nee 
OFF (Failure) 
Overpressure bit is 


reset, but device 
remains in the state 


Sensor Alarm, 
High Voltage Sensor Alarm Detected because of other 
ON Sensor Alarms 


See the S-Device Supervisor object (Chapter 5-35) for more information on the Executing 
State. 


Table 5-36.27 S-Analog Sensor Sub-State Event Matrix 


SUB - STATE 


High Voltage OFF High Voltage ON Sensor Alarm 
EVENT High Voltage Off 
Set High Voltage State ON Request | Transition to High Voltage _| Error AIRS * Error OSC ** 
ON 
Set High Voltage State OFF Request |Error AIRS * Transition to High Voltage | Error OSC ** 
OFF 


Electronics Failure Transition to Sensor Alarm _ |Transition to Sensor Event reported in Sensor 
High Voltage Off Alarm Alarm 
High Voltage Off 
Overtemperature Transition to Sensor Alarm _ |Transition to Sensor Event reported in Sensor 
High Voltage Off Alarm Alarm 
High Voltage Off 
Clear Overpressure High Voltage Off |Not Applicable Not Applicable Transition to 


Alarm Request (Condition: ONLY High Voltage OFF 
Overpressure High Voltage Off in Sensor 

Alarm set) 

Clear Overpressure High Voltage Off |Not Applicable Not Applicable Error OSC ** 


Alarm Request (Condition: Overpressure 
Emission Off and other Sensor Alarms set) 


Clear Overpressure High Voltage Off |Error AIRS * Error OSC ** Not Applicable 
Alarm Request (Sensor Alarms not set) 

* Error AIRS = Error Response “Already in Requested Mode/State” (Code OBhex) 

** Error OSC = Error Response “Object State Conflict” (Code 0C),.x) 
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5-36.12 S-Analog Sensor Object Instance Subclass 05 (Hot Cathode Ion 
Gauge) 


Following is a subclass extension to the S-Analog Sensor Object. The original usage for the 
subclass is for Hot Cathode Ion Vacuum Gauges. The Hot Cathode Ion Vacuum Gauge 
extension is used in conjunction with the Vacuum/Pressure Gauge Profile providing control 
and status information. 


A Hot Cathode Ion Vacuum Gauge is a device that measures pressure at vacuum levels. It 
contains a hot filament for the generation of free electrons which are accelerated (emission 
current) and, by collision, generate ionized gas molecules. The positive ionized molecules are 
attracted to, and collected by, a negatively charged collector (collector current). The ratio of 
the two currents (collector to emission) is proportional to the pressure. 


Generally, these devices support a ”degas” mode of operation by a resistive method or an 
electron bombardment method. 


5-36.12.1 Instance Attributes 


Certain minimal implementations may support any optional ”Set” attributes as ”Get” only and 
still be compliant with this subclass specification. All required attributes must be supported as 
specified. 


Table 5-36.28 Hot Cathode Ion Gauge Subclass Instance Attributes 
ID_| Implementation | Rule Type Attribute 
79 | Optional Get V_ | Filament Bias Diagnostic readout | Volts 
Voltage of filament bias [default] = vendor 
voltage specific 
80 | Optional Set V_ |Grid Voltage |REAL | Setting of grid Volts 
voltage. [default] = vendor 
specific 
81 | Conditional Set V_ | Active Degas Indicates which Bit mapped byte of 
See Semantics Filament degas filament is up to 8 filaments as 
selected. specified by the 
Vendor. 
See Semantics 
82 | Optional Set NV | Degas Power |REAL | Indicates degas Power in Watts 
power in watts [default] = vendor 
specific 
83 | Optional Get V_ | Filament Indicates actual Filament Current in 
Current filament current in | amps. 
A [default] = vendor 
specific 
84 | Optional Get V_ | Degas Time Remaining time, in | [default] = 0 
Off seconds, for the See Semantics 
Remaining current degas off 
cycle. 


85 | Optional Set NV | Degas Time Minimum time, in {default] = vendor 
Off Interval seconds, between specific 
consecutive degas See Semantics 
functions. 
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Attr 
ID 
86 


87 


88 


89 


90 


91 


92 


93 


94 


95 


96 


S-Analog Sensor Object, Class Code: 314¢x 


Need in 
Implementation 
Optional 


Optional 


Optional 


Conditional 
See Semantics 


Optional 


Optional 


Optional 


Required 


Optional 


Optional 


Optional 


Access | NV 
Rule 


Get 


Vv 


Set Vv 


>) 
m 


Vv 


Set 


Set NV 


Set NV 


Set 


Get 


Get 


Get 


< 


< < < Z Zz 
a ff 


Get 


Name ae Description of Semantics of Values 
Attribute 


Remaining time, in 
seconds, for the 
current degas on 


ia Time 
On 
Remaining 


Degas Time 
On Interval 


UINT 


pesiuaae| Status | BOOL 


haath 
Filament 


BYTE 


Sensitivity REAL 


Emission 
Current 


Mode 
Filament 
Selection 
Emission 
Status 


Sensor 
Warning 


Status 


Extension 


Sensor Alarm 


REAL 


BOOL 
BOOL 


STRU 


BYTE 


cycle. 

Indicates the length 
of time, in seconds, 
that degas is on. 
a ae current 
a ae state. 
Indicates which 
filament(s) is/are 
selected. 


Conversion Factor 
from current ratio to 
pressure 

Indicates setting 
level of emission 
current in amps. 

Can be indicated in 
either continuous or 
discrete readings 
allowed by the 
vendor. 

Selects automatic or 
user filament 
selection 

Indicates whether 
the emission is 
turned on or off. 
Bit definitions of 
Sensor Warnings 


Bit definitions of 
Sensor Alarms 


Bit-mapped byte 
providing additional 
status bits of an S- 
Analog Sensor 


instance. 


[default] = 
See Semantics 


[default] = vendor 
specific 

See Semantics 

0 = Off 

1=On 

Bit mapped byte of 
up to 8 filaments as 
specified by the 
Vendor. 


See Semantics 
{default] = 1.0 

see Semantics 
section 

Vendor specifies the 
range of supported 
values and the 
[default] 

Note: Degas Mode 
may override this 
setting. 


see Semantics 

0 = automatic 

1 = user [default] 
0 = Off 

1=On 


[default=0] 


see Semantics 


[default=0] 
see Semantics 


[default=0] 
see Semantics 
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5-36.12.2.1 


5-36.12.2.2 


5-36.12.2.3 


5-36.12.2.4 
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Semantics 


Active Degas Filament 
Indicates which degas filament is active. 0 = off / 1 = on. Filament selection may be made 
either automatically by the device, or remotely by setting this attribute. 


Table 5-36.29 Active Degas Filament Attribute 


pi7 | pice | wes | ica | ics | ier | ier | Bio 
Degas 


Degas Degas Degas Degas Degas Degas Degas 
Filament 8 | Filament 7 | Filament 6 | Filament 5 | Filament 4 | Filament 3 | Filament 2 | Filament 1 


Degas Time Off Interval and Degas Time Off Remaining 


The Degas Time Off Interval attribute specifies the minimum time, in seconds, between degas 
cycles. The valid range for this attribute is manufacturer specific. 


The Degas Time Off Remaining attribute provides the remaining time, in seconds, before a new 
degas cycle can be started. When the Degas Status attribute transitions to the Off state, the 
Degas Time Off Remaining attribute is set to the value of the Degas Time Off Interval 

attribute. The device then decrements the value of the Degas Time Off Remaining attribute at 
one second intervals until the attribute value reaches zero. The “Object State Conflict” error 
response will be returned for all Set Degas State ON requests received while the value of the 
Degas Time Off Remaining attribute is greater than zero. 


Degas Time On Interval and Degas Time On Remaining 


The Degas Time On Interval attribute specifies the maximum time, in seconds, for degas. The 
manufacturer may limit the maximum value for this attribute. 


The Degas Time On Remaining attribute provides the remaining time, in seconds, for the 
current degas cycle. When the Degas Status attribute transitions to the On state, the Degas 
Time On Remaining attribute is set to the value of the Degas Time On Interval attribute. The 
device decrements the value of the Degas Time On Remaining attribute at one second intervals 
and stops the active degas cycle when the attribute value reaches zero. Whenever the Degas 
Status attribute transitions to the Off state from the On state, e.g. alarm detected, Set Degas 
State request received, etc., the Degas Time On Remaining attribute is set to the value zero. 


Active Filament 
Indicates which degas filament is active. 0 = off/1=on. Filament selection may be made 
either automatically by the device, or remotely by setting this attribute. 


Table 5-36.30 Active Filament Attribute 


pe7 | pies | pies | pies | pics | wie2 | pier | pico 
Sensor 


Sensor Sensor Sensor Sensor Sensor Sensor Sensor 
Filament 8 | Filament 7 | Filament 6 | Filament 5 | Filament 4 | Filament 3 | Filament 2 | Filament 1 
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5-36.12.2.5 Sensitivity 


The conversion factor used to convert the ratio of gauge currents to pressure using the 
following formula: 


P = (1/S) (C/E) 


Where: 

P = pressure (Value attribute) 

S = sensitivity (Sensitivity attribute) 

C = collector current (measured by the device, Amps) 

E = emission current (Emission Current attribute, Amps) 


Sensitivity units are in inverse pressure units. 


5-36.12.2.6 Mode Filament Selection 


The Mode Filament Selection attribute determines whether devices with multiple filaments 
automatically select the active filament(s) for Emission and Degas ON, or whether the user 
manually selects the filament(s). 


5-36.12.2.6.1 Automatic Filament Selection 


With “Automatic Filament Selection” (Mode Filament Selection attribute = 0), the device 
determines, using a manufacturer specific algorithm, which filament to use for Emission ON 
and Degas ON. When the device is configured for automatic filament selection, the Active 
Filament and Active Degas Filament attributes have Get access. 


If a filament(s) is broken, the corresponding bit(s) in the Sensor Warning attribute is set, and 
the device selection algorithm must avoid selecting the broken filament(s). 


5-36.12.2.6.2 User Filament Selection 


With “User Filament Selection” (Mode Filament Selection attribute = 1), the user selects which 
filament to use for Emission ON and Degas ON. When the device is configured for user 
filament selection: 


1. The Active Filament attribute has Set access. 

2. The Active Degas Filament attribute has Set access if the device supports individual 
selection of the Emission and Degas ON filaments. If the device uses the same filament for 
Emission and Degas ON, the Active Degas Filament has Get access. 

3. Ifthe user attempts to select a Filament that is broken, the device returns an ”Invalid 
Attribute Value” error response. 


For devices that support User Filament Selection Mode and which provide multiple filaments, 
the Active Filament and Active Degas Filament (if the device supports degas) attributes are 
required. The behavior of a device with more than one filament on is device specific. 
Generally, this will not be permitted and attempts to do so will return an error. 
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5-36.12.2.7 


5-36.12.2.8 


5-36.12.2.9 
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Sensor Warning 


The Sensor Warning attribute provides 16 bits for the current Sensor Warning state of the 
object. The Sensor Warning attribute also maps to the S-Device Supervisor Exception Detail 
Warning attribute as specified in the Vacuum/Pressure Gauge device profile. The following 
table provides definitions for each Sensor Warning bit. Reserved bits must be set to zero. 


Table 5-36.31 Sensor Warning Attribute 


Data Bit 7 Bit5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 

Component 
Sensor Sensor Sensor Sensor Sensor Sensor 
Warning Byte | Filament 8 | Filament 7 | Filament 6 | Filament 5 | Filament 4 | Filament 3 | Filament 2 | Filament 1 
0 Warning Warning Warning Warning Warning 
Sensor High Low Reserved | Sensor Pressure | Reserved | Electronics | Exceeded 
Warning Byte Warning | Warning Warning * | Too High Maximum 
1 Exception | Exception For Degas C/E Ratio 


* Bit 4 of Byte 1, *Sensor Warning” relates to error conditions of the filament (cathode), anode, and ion collector. 


Sensor Alarm 


The Sensor Alarm attribute provides 16 bits for the current Sensor Alarm state of the object. 
The Sensor Alarm attribute also maps to the S-Device Supervisor Exception Detail Alarm 
attribute as specified in the Vacuum/Pressure Gauge device profile. The following table 
provides definitions for each Sensor Alarm bit. Reserved bits must be set to zero. 


Table 5-36.32 Sensor Alarm Attribute 


Data Bit 7 Bit 5 Bit 3 Bit 2 Bit 1 Bit 0 
Component 
Sensor Alarm Sensor Sensor Sensor Sensor Sensor Sensor Sensor Sensor 
Byte 0 Filament 8 | Filament 7 |Filament6 |Filament5 | Filament 4 | Filament 3 | Filament 2 Filament 1 


Alarm Alarm Alarm Alarm Alarm Alarm Alarm Alarm 


Sensor Alarm High Alarm | Low Alarm | Reserved Environme | Overpressur | Over Electronics | Exceeded 
Byte 1 Exception | Exception nt Failure * |e Emission | Temperatur | Failure Maximum 
Off e of C/E Ratio 

Electronics 


* Bit 4 of Byte 1, ”Environment Failure” relates to environment error conditions of the filament (cathode), anode, and ion collector 
which could cause an automatic emission off. 


Status Extension 
8 Bits providing the current sensor alarm state of the object. 


Table 5-36.33 Status Extension Attribute 
Bit7 | Bite | Bit 0 


Reserved | Reserved | Reserved | Reserved Overrange | Reading 
Exceeded | Invalid* 


* Note: Logical inversion of Reading Valid 
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5-36.12.3 Services 


The following instance-level services are defined for this subclass of the S-Analog Sensor 
object: 


Table 5-36.34 Hot Cathode Ion Gauge Subclass Instance Attributes 


Service | Need in Implementation Service Name Description of Service 


61 nex n/a Optional Set Degas State Activate/deactivates degas mode 
according to the parameter Degas State. Degas mode 
may be terminated either automatically by device 
timeout, or remotely by this service. 


62 hex n/a Conditional * | Set Emission State | Turns the filament on and off according to the 
parameter Emission State 


63 hex n/a Conditional * | Clear Emission Off | Clears the Alarm attributes after an automatic 
Alarm ”emission off”. This service acknowledges and 
attempts to reset the Overpressure Emission Off and 
Exceeded Maximum C/E Ratio and Environment 
Failure Alarm attributes before an Emission State 
ON can be applied. 


* Required for single gauges only, otherwise support is optional 


5-36.12.3.1 Clear Emission Off Alarm Service 


If the emission is switched off automatically in case of an overpressure or any other 
environmental (for example glow discharge) or Exceeded Maximum C/E Ratio condition, it is 
not possible to switch on the emission again before the related Alarm attribute is reset. This 
service resets the Alarm attributes: Overpressure Emission Off and Exceeded Maximum C/E 
Ratio and Environment Failure. See the State Event Matrix in section 5-36.11.2 for additional 
information. 


5-36.12.3.2 Set Emission State 


Table 5-36.35 Set Emission State Service Data Field Parameters 


EmissionState Required BOOL See Behavior 0 = switches Emission OFF 
1 = switches Emission ON 


5-36.12.3.3 Set Degas State 


Table 5-36.36 Set Degas State Service Data Field Parameters 


DegasState Required BOOL See Behavior 0 = switches Degas OFF 
1 = switches Degas ON 


— 5-304 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 5 


S-Analog Sensor Object, Class Code: 314¢x 


5-36.12.4 Behavior 


5-36.12.4.1 Sensor Alarms/Warnings: Filaments 


When the Mode Filament Selection attribute is set to “User or Automatic Filament Selection ”, 
if any bit of the Sensor Alarm attribute is set, the emission is switched off automatically. If a 
filament is broken, the corresponding bit in the Sensor Warning attribute is set. 


When the Mode Filament Selection attribute is set to “User Filament Selection”, if the selected 
filament is broken, the corresponding bits in both the Sensor Warning and Sensor Alarm 
attributes are set and the device transitions to the state Sensor Alarm Emission Off . The alarm 
is cleared by selecting a new active filament and the device transitions to the state Emission 
Off. In this case the warning bit remains set and the alarm bit gets cleared. 


When the Mode Filament Selection attribute is set to “Automatic Filament Selection”, the 
device sets all warning bits of all sensor filaments that are broken or failed. If the selected 
filament is broken, the device selects a new filament automatically and sets the warning bit 
of the new failed filament. If all filaments are broken, the corresponding bits in the Sensor 
Alarm attribute are set and the device transitions to the state Sensor Alarm Emission Off 


5-36.12.4.2 Sensor Alarm Byte 1: 
5-36.12.4.2.1 Bit 0: Exceeded Maximum C/E Ratio 


In case of an Exceeded Maximum C/E Ratio the device transitions to the state Sensor Alarm 
Emission Off. This error condition has to be acknowledged before the emission could be 
switched on again. This acknowledge is done by the service Clear Emission Off Alarm. After 
receiving this service, the device transitions to the state Emission Off. 


5-36.12.4.2.2 Bit 1: Electronics Failure 
The device has detected an internal electronics failure which could not be cleared. The 
emission is switched off and the device transitions to the state Sensor Alarm Emission Off. 


5-36.12.4.2.3 Bit 2: Over Temperature of Electronics 


The devices temperature is above its specified range. The emission is switched off and the 
device transitions to the state Sensor Alarm Emission Off and remains there until the 
temperature is below the critical limit. If the user attempts to switch on the emission while this 
bit is set, the error response Object State Conflict is returned. If the temperature goes below the 
critical limit, the device automatically transitions to the state Emission Off. 


5-36.12.4.2.4 Bit 3: Overpressure Emission Off 


In case of an overpressure emission off, the user has to acknowledge the reason of the Emission 
Off situation. The acknowledge is done by the service: Clear Emission Off Alarm. After 
receiving this service, the device transitions to the state Emission Off. 


5-36.12.4.2.5 Bit 4: Environment Failure 


Some other reasons than an overpressure condition (for example grid error or emission current 
being lost to a plasma) may result in an automatic emission switch off. This bit is set after any 
kind of these clearable emission switch off conditions. In this case the device transitions to the 
state Sensor Alarm Emission Off. The service Clear Emission Off Alarm is used to 
acknowledge the error condition and the device transitions to the state Emission Off. 
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5-36.12.4.3. 


5-36.12.5 


S-Analog Sensor Object, Class Code: 31 4x 


Sensor Warning Byte 1: 
1 Bit 3: Pressure Too High For Degas 


If the pressure is above the manufacturer-specified range at which degas is allowed, this bit will 
be set. This bit is cleared if the pressure is below the manufacturer specified range at which 
degas is allowed. 


S-Analog Sensor Object Sub-State for the Executing State 


Figure 5-36.37 S-Analog Sensor Object Instance Behavior 
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See the S-Device Supervisor object (Section 5-35) for more information on the Executing 
State. 


Sensor Alarm Detected 
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S-Analog Sensor Sub-State Event Matrix 


Table 5-36.38 S-Analog Sensor Sub-State Event Matrix 


Sub-State 
Emission OFF Emission ON No | Emission ON | Sensor Alarm Degas On 
Event Degas Range Degas Range | Emission Off 
Electronics Failure Transition to Transition to Transition to Event reported |Transition to 


Sensor Alarm Sensor Alarm Sensor Alarm in Sensor Alarm | Sensor Alarm 


Emission Off Emission Off Emission Off Emission Off 
Overtemperature Transition to Transition to Transition to Event reported | Transition to 
Sensor Alarm Sensor Alarm Sensor Alarm in Sensor Alarm Sensor Alarm 
Emission Off Emission Off Emission Off Emission Off 
Temperature falls below Transition to 
overtemperature limit iets catebie Pe teu Emission Off irate 
Environmental Failure Transition to Transition to Transition to 
like glow discharge Sensor Alarm Sensor Alarm Sensor Alarm 
Emission Off issi Emission Off 
Exceeded Maximum C/E Transition to Transition to Transition to 
Ratio Sensor Alarm Sensor Alarm Sensor Alarm 
Emission Off issi Emission Off 
Clear Emission Off Alarm Transition to Not 


Request i i i Emission OFF — |“PPlicable 
(Condition: ONLY 
Overpressure Emission Off 
and/or Sensor Failure and/or 
Exceeded Maximum C/E 
Ratio in Sensor Alarm set) 


Clear Emission Off Alarm Error OSC ** |Not 
Request Applicable 
(Condition: Overpressure 
Emission Off and/or Sensor 
Failure and/or Exceeded 
Maximum C/E Ratio and 
other Sensor Alarms set) 
Filament Alarm Transition to Transition to Transition to 


Sensor Alarm Sensor Alarm i Sensor Alarm 
Emission Off Emission Off Emission Off 


Clear Emission Off Alarm Error AIRS * Error OSC ** Error OSC ** 
Request 

(Sensor Alarms not set) 

Set Emission State On Transition to Error AIRS * Error AIRS *_ |Error OSC ** |Error AIRS * 
Request and current pressure | pmission ON 

<= minimum degas pressure | pegas Range 

Set Emission State On Transition to Error AIRS * Error AIRS * |Error OSC ** |Error AIRS * 
Request and current pressure | Fmission ON No 

> minimum degas pressure —_| Degas Range 

Set Emission State On Error OSC ** Error AIRS * Error AIRS * |Error OSC ** |Error OSC ** 
Request 

at a broken filament in case 

of user filament selection 

Emission State On Request | Not Applicable Not Applicable Not Applicable |Error OSC ** | Not Applicable 
all filaments broken 
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Sub-State 
Emission OFF Emission ON No | Emission ON | Sensor Alarm Degas On 
Event Degas Range Degas Range | Emission Off 
Current Pressure <= Ignore Event Transition to Ignore Event Ignore Event Ignore Event 
minimum degas pressure Emission ON 
Degas Range 
Current Pressure <= Ignore Event Transition to Ignore Event Ignore Event  |Ignore Event 
minimum degas pressure Emission ON 
Degas Range 
Current Pressure > minimum |Ignore Event Ignore Event Transition to Ignore Event _| Transition to 
degas pressure Emission ON No Emission ON No 
Degas Range Degas Range 
Valid Set Degas State On Error OSC ** —_| Error OSC ** Transition to Error OSC **  |Error AIRS * 
Request Degas On 
Set Degas State On Request |Error OSC ** Error OSC ** Error OSC ** |Error OSC ** |Error AIRS * 
at a broken filament in case 
of user filament selection 


Set Degas State On Request |Error OSC ** Error OSC ** Error OSC ** |Error OSC ** | Not Applicable 

and 

Degas Time Off Remaining 

attribute > 0 

Set Degas State Off Request |Error OSC ** —|Error OSC ** Error OSC ** |Error OSC ** [Transition to 
Emission ON 


Degas Time On Remaining |Not Applicable | Not Applicable Not Applicable |Not Applicable |Transition to 
attribute decrements to zero Emission ON 


Degas Range 


* Error AIRS = Error Response “Already in Requested Mode/State” (Code OBnex) 
** Error OSC = Error Response “Object State Conflict” (Code OCh¢x) 
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5-36.13 S-Analog Sensor Object Instance Subclass 06 - Transfer Function 
The following specification applies to a subclass of this object. 


5-36.13.1 Instance Attributes 


Table 5-36.39 Transfer Function Subclass Instance Attributes 


Attr ID Needin | Access| NV| Name Data Type | Description of Semantics of Values 
Implem Rule Attribute 


96 Optional Set | NV |Pressure Select function 0 = None (linear) 

Variable modifier of 1 = Log() 

Mapping variable source to |2 = Exp() 

Function convert to selected |3= Interpolate, 

i manufacturer specific. 

4-127 = Reserved by CIP 
128-255 = Vendor 
Specific 
See Semantics section for 
usage 
[default] = 0 


5-36.13.2 Semantics 


5-36.13.2.1 Pressure Variable Mapping Function 


This attribute specifies an added function to the analog sensor object for the pressure variable 
sensor. This is to allow flexibility in connecting non-intelligent pressure devices to the Process 
Control Valve. The object uses: 


Value = Gain (Sensor Reading + Offset-A ) + Offset-B 


Which is now embellished as: 
Value = Gain (Function(Sensor Reading + Offset-A) ) + Offset-B 


Where Function() is one of the following for each attribute value: 


0: Value = Gain (Sensor Reading + Offset-A) + Offset-B 

1: Value = Gain (Log10(Sensor Reading + Offset-A) ) + Offset-B 
2: Value = Gain (Exp10(Sensor Reading + Offset-A) ) + Offset-B 
3: Value = Gain (Interp(Sensor Reading + Offset-A) ) + Offset-B 
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5-37 S-Analog Actuator Object 
Class Code: 32tHex 


The S-Analog Actuator Object models the interface to a physical actuator in a device. 
Associated with an analog actuator is a value which is corrected with an offset and a gain 
coefficient, optionally settable in the object before it is output to the physical actuator. 
Manufacturers may specify additional correction algorithms as extensions to this object. 


The context of this object is that of an “Actuator” which should not be confused with a 
“Valve”. In particular, ZERO corresponds to the default powered-off state or typically NOT 
ACTUATED. For example, an S-Analog Actuator object physically connected to a Normally 
Open Valve, would result in the Valve being ON (i.e.: open or flowing) when the Actuator is 
ZERO (i.e.: not actuated). 


Additionally, the S-Analog Actuator Object provides two sets of trip-point definitions. The 
behavior associated with these trip points is described in sections below. 


This object is a member of the Hierarchy of Semiconductor Equipment Devices. As such, its 
behavior is managed by the S-Device Supervisor Object. See Section 5-35. 


5-37.1 Class Attributes 


Table 5-37.1 S-Analog Actuator Object Class Attributes 


Attribute Need in Access Name Data Type Description of Attribute 
ID implementation | Rule 


1 thru 7 | These class attributes are optional and are described in Chapter 4 of this specification. 


Reserved by CIP for Future Use 


- 


* Tf the value of Subclass is 00, which identifies "no subclass", then this attribute is OPTIONAL in 
implementation, otherwise, this attribute is REQUIRED. 


Identifies a subset of additional 
class attributes, services and 
behaviors. 


5-37.1.1 Subclasses 


Each class level subclass defines a unique meaning for an overlapping range of class attribute 
IDs and/or class service IDs. The range for subclass definitions begins at ID 96 and numbers 
downward for attributes, and ID 63), and numbers downward for services. The subclass for a 
given class is identified by the value of its Subclass class attribute. The subclasses for this 
object are specified at the end of this object specification section. 
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Instance Attributes 


Certain minimal implementations may support any optional “Set” attributes as “Get” only and 
still be compliant with this object specification. All required attributes must be supported as 
specified. 


Table 5-37.2 S-Analog Actuator Object Instance Attributes 


Attr Need in Access | NV Name Data Type Description of Semantics of 
ID | Implementation Rule Attribute Values 
1 |Optional Get NV |Numberof |USINT Number of The number of 
Attributes supported attributes 
attributes supported by this 
object instance 
2  |Optional Get NV {Attribute List |ARRAY OF  |List of supported |List of attributes 
USINT attribute supported by this 
object instance 


Optional See NV _ |Data Type USINT Determines the _|see Semantics 
Semantics Data Type of section 
Value and all 
related attributes 
as specified in 
this table. 
Value INT or Analog output The uncorrected 

specified by 

Data Type if 

Supported [default] = 0 

BOOL Enables the 0 = disable 
setting of the [default] 
Warning Bit 1 = enable 


4 |Optional See NV_ |Data Units ENGUNITS Determines the _|see Semantics 
Semantics context of Value |section 
Vv 
value value. see 
Vv Status BYTE Alarm and see Semantics 
Warning State of |section 
this object [default] = 0 
instance 
Offset INT or 


w 


por 
pr 


Set 

Set 

et 

Set 

Set 

Set 
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An amount to be |see Semantics 
added to Value section 

prior to the 0 = [default] 
application of 

gain 


Override USINT Specifies an 0 = normal 
override for the |[default] 
physical actuator. |< Semantics 
For values other section 
than zero (normal 
control), the 
Value attribute is 
ignored. 

Semantics section 

Alarm Enable |BOOL Enables the 0 = disable 
setting of the [default] 
Alarm Bit 1 = enable 

specified by 


Data Type if 
supported 
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ID 
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12 


13 


14 


15 


16 


17 


18 


19 


20 


S-Analog Actuator Object, Class Code: 32x 


Need in Access Name Data Type Description of 
—— Rule Attribute 


Required if 


NV _ |Bias INT or 
specified by 
Data Type if 
supported 
Gain Data USINT 
Type 


Z 
< 


Attribute “Gain” 
is other than 


REAL 

Optional NV_ |Gain REAL or 
specified by 
Gain Data 
Type if 
supported 


Unity Gain 
Reference 


Z 
< 


REAL or 
specified by 
Gain Data 
Type if 
supported 


Required if 
Attribute 12 is 
other than REAL 


ad 
Tf 


Z 
< 


INT or 
specified by 
Data Type if 
supported 


Alarm Trip 
Point High 


INT or 
specified by 
Data Type if 
supported 


Alarm Trip 
Point Low 


Z 
< 


INT or 
specified by 
Data Type if 
supported 


Alarm 
Hysteresis 


Z 
< 


INT or 
specified by 
Data Type if 
supported 


Warning Trip 
Point High 


Z 
< 


Z Z 
a, a ae a ee ee ae ee 


INT or 
specified by 
Data Type if 
supported 


Warning Trip 
Point Low 


INT or 
specified by 
Data Type if 
supported 
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An amount to be 
added to Value 
after the 
application of 
gain 


Determines the 
Data Type of 
attribute Gain 


An amount by 
which Value is 
scaled prior to 
driving the 
physical actuator 


Specifies the 
value of the Gain 
attribute 
equivalent to a 
gain of 1.0 


Determines the 
Value above 
which an Alarm 
Condition will 
occur 


Determines the 
Value below 
which an Alarm 
Condition will 
occur 


Determines the 
amount by which 
the Value must 
recover to clear 
an Alarm 
Condition 


Determines the 
Value above 
which a Warning 
Condition will 
occur 


Determines the 
Value below 
which a Warning 
Condition will 
occur 


Determines the 
amount by which 
the Value must 
recover to clear a 
Warning 
Condition 


Semantics of 
Values 


see Semantics 
section 


0 = [default] 


see Semantics 
section 


see Semantics 
section 


1.0 = [default] 


Used for 
normalizing the 
Gain attribute. 


see Semantics 
section 


[default] = 1.0 


see Semantics 
section 


[default] = 
Maximum value 
for its data type. 


see Semantics 
section 


[default] = 
Minimum value 
for its data type. 


see Semantics 
section 


[default] = 0 


see Semantics 
section 


[default] = 
Maximum value 
for its data type. 


see Semantics 
section 


[default] = 
Minimum value 
for its data type. 


see Semantics 
section 


[default] = 0 
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5-37.2.2 
5-37.2.2.1 


5-37.2.2.2 


S-Analog Actuator Object, Class Code: 32x 
Semantics of 


Need in Access | NV Name Data Type Description of 
Implementation Rule Attribute Values 


Optional Set NV _ |Safe State USINT Specifies the see Semantics 
behavior of the | section 
physical actuator |g — [default] 
for states other 
than Execute 

Optional Set NV |Safe Value {INT or The Value to be |see Semantics 

specified by used for Safe section 
Data Type if |State = Safe 0 = [default] 
supported Value 


97-98 | Reserved by CIP for Future Use 


99 |Conditional * Get NV_ {Subclass UINT Identifies a subset |0 = No subclass 
of additional 1—65535 = 
instance Reserved 
attributes, 
services and 
behaviors. 


* Tf the value of Subclass is 00, then this attribute is OPTIONAL in implementation, otherwise, this attribute is 
REQUIRED. 


21 


22 


Subclasses 


Each instance level subclass defines a unique meaning for an overlapping range of instance 
attribute IDs and/or instance service IDs. The range for subclass definitions begins at ID 96 
and numbers downward for attributes, and ID 63;., and numbers downward for services. The 
subclass for a given instance is identified by the value of its Subclass instance attribute. The 
subclasses for this object are specified at the end of this object specification section. 


Semantics: 


Data Type 
All Data Type attributes, including Data Type and Gain Data Type, use the enumerated values 
specified in Appendix C-6.1. 


The Data Type attribute is settable only in the Idle State and only if no attribute belonging to 
the object instance is the endpoint of an I/O connection in the Established State. 


The Data Type attribute may change automatically based upon established I/O connections. See 
Behavior section for more information on this mechanism. 


Data Units 


Specifies the context of Value and related attributes (such as, offset and trip points) for this 
object instance. See Appendix D for a list of values. A request to set attribute to an unsupported 
value will return an error response. 


The Data Units attribute is settable only in the Idle State. 
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5-37.2.2.4 


5-37.2.2.5 


S-Analog Actuator Object, Class Code: 32x 


Value, Offset, Gain, Bias and Unity Gain Reference 


The Offset, Gain and Bias attributes are applied to the Value attribute to derive the actual signal 
which drives the physical actuator. The gain is normalized using the Unity Gain Reference 
attribute value. (e.g., for an UINT type Gain, a Unity Gain Reference value may be 10000, 
allowing an effective gain of 0.0001 to 6.5535.) 


The following formula applies: 
physical actuator drive signal = Gainy ¢ ( Value + Offset ) + Bias 
where: Gainy = Gain / Unity Gain Reference 


There may be additional nonlinear conversions applied to the drive signal as specified by the 
manufacturer. 


Status 


A bit mapped byte which indicates the Alarm and Warning Exception status of the object 
instance. The following definition applies: 


Table 5-37.3 Status Attribute 


Definition 


2 
= 


0 High Alarm Exception: 0 = cleared; 1 = set 

1 Low Alarm Exception: 0 = cleared; 1 = set 

2 High Warning Exception: 0 = cleared; 1 = set 
3 Low Warning Exception: 0 = cleared; 1 = set 
4 Reserved 

5 Reserved 

6 Reserved 

Ti Reserved 


Trip Points and Hysteresis 


Trip Point High is the level above which the Value attribute will cause an Alarm or Warning 
exception condition. 


Trip Point Low is the level below which the Value attribute will cause an Alarm or Warning 
exception condition. 


A Hysteresis value specifies the amount by which the Value attribute must transition in order to 
clear an Alarm or Warning condition. 


For example: A Trip Point High value of 90 and a Hysteresis value of 2 will result in an 
exception condition being set when the Value is above 90 and cleared when the Value drops 
below 88. Similarly, A Trip Point Low value of 90 and a Hysteresis value of 2 will result in an 
exception condition being set when the Value is below 90 and cleared when the Value increases 
above 92. 
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5-37.2.2.7 


5-37.2.2.8 


S-Analog Actuator Object, Class Code: 32x 


Override 


This attribute is used to override the function of the Value attribute in driving the physical 
actuator. The primary application of this feature is in devices where the object instance is being 
driven by another object such as an S-Single Stage Controller object instance. 


The Safe State attribute provides a mechanism for override depending upon object state and 
will take precedents over this. That is, if an object instance implements the Safe State attribute 
and related behavior, then this Override attribute and related behavior will only function in the 
Executing State. 


Table 5-37.4 Override Attribute 


Attribute Value State 
0 Normal 
1 Zero 
2 Maximum Value 
3 Hold 
4 Safe State 
5-63 reserved 
64-127 Device Specific 
128-255 Vendor Specific 
Safe State 


This attribute specifies the behavior of the drive to the physical actuator for states other than 
Executing. See the S-Device Supervisor object definition in Section 5-35. for a description of 
object states. The following values are defined: 


Table 5-37.5 Safe State Attribute 


Attribute Value State 
0 Zero 
1 Maximum Value 
2 Hold Last Value 
3 Use Safe Value 
4-63 Reserved 
64-127 Device Specific 
128-255 Vendor Specific 
Safe Value 


For Safe State set to “Use Safe Value”, this attribute holds the value to which the actuator will 
be driven for object instance states other than Executing. Specifically, this attribute value will 
become the value of the Value attribute. Therefore, the correction formula specified above 
applies. 
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5-37.3. Common Services 
The S-Analog Actuator Object provides the following Common Services: 


Table 5-37.6 S-Analog Actuator Object Common Services 


Service Service Name Description of Service 


Code 


Need in Implementation 


eet tea 


n/a Set_Attribute_Single 


*The Get_Attribute_Single service is REQUIRED if any attributes are implemented. 


Returns the contents of the 
specified attribute. 


Modifies an attribute value. 


See Appendix A for definition of these services 
5-37.4 Object—Specific Services 


The S-Analog Actuator Object provides no Object—Specific services. 


5-37.5 Behavior 
The behavior of this object is managed by the S-Device Supervisor Object in Section 5-35.6. 


An S-Analog Actuator object instance modifies the Value by applying the formula specified 
above with the associated attribute values. Value is specified as Data Type and Data Units. 
Optionally, additional corrective algorithms are applied to further correct for various 
calibration effects. These additional algorithms are specified in other objects, as identified in 
the device profile, or as extensions, specified by the manufacturer. 


All Trip Point calculations, as specified above, utilize the Value attribute before the application 
of Offset and Gain. 


5-37.5.1 Data Type 


If the implementation of this object specifies more than one valid Data Type value, in the 
device profile or by vendor, then the following behavior with respect to Data Type applies: 
The Data Type value will be set automatically based upon the first valid I/O connection 
established by the device. This configuration will then remain in effect for this object instance 
even after all I/O connections are lost. If, however, a device is specified by a vendor to support 
only one Data Type, this behavior is not supported. 


If no established I/O connections exist, which include an attribute from this object, then the 
Data Type attribute is settable provided that the object is in the Idle State. 


The following example demonstrates this behavior: 


A device profile specifies an instance of the S-Analog Actuator object as well as two static 
Assembly object instances, both with data attribute components mapped to this object instance. 
Assembly object instance ID 1 specifies INT data types and Assembly object instance ID 2 
specifies REAL data types. 
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After the device is On-Line, it is configured with an I/O connection to Assembly instance ID 2. 
When the connection transitions to the Established State, this object instance attribute Data 
Type is automatically set with the value for REAL before any data is communicated to, or 
from, the object instance. 
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S-Single Stage Controller Object 
Class Code: 33 Hex 


The S-Single Stage Controller Object models a closed-loop control system within a device. 
Associated with a single stage controller is a Process Variable, a Setpoint and a Control 
Variable. As normally described by classic control theory, a closed-loop controller will drive 
the Control Variable in order to affect the value of the Process Variable such that it is made to 
equal the Setpoint. See the Semantics section, below, for more information regarding these 
variable definitions. Manufacturers may specify additional correction algorithms as extensions 
to this object. 


This object is a member of the Hierarchy of Semiconductor Equipment Devices. As such, its 
behavior is managed by the S-Device Supervisor Object. See Section 5-35. 


Class Attributes 


Table 5-38.1 S-Single Stage Controller Object Class Attributes 


Attribute Need in Access Name Data Type Description of Attribute 
ID implementation | Rule 


1 thru 7 | These class attributes are optional and are described in Chapter 4 of this specification. 


Reserved by CIP for Future Use 


* Tf the value of Subclass is 00, which identifies "no subclass", then this attribute is OPTIONAL in 
implementation, otherwise, this attribute is REQUIRED. 


Identifies a subset of additional class 
attributes, services and behaviors. 


Subclasses 


Each class level subclass defines a unique meaning for an overlapping range of class attribute 
IDs and/or class service IDs. The range for subclass definitions begins at ID 96 and numbers 
downward for attributes, and ID 63), and numbers downward for services. The subclass for a 
given class is identified by the value of its Subclass class attribute. The subclasses for this 
object are specified at the end of this object specification section. 
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Instance Attributes 
Certain minimal implementations may support any optional “Set” attributes as “Get” only and 
still be compliant with this object specification. All required attributes must be supported as 


specified. 


Table 5-38.2 S-Single Stage Controller Object Instance Attributes 


Attr Need in Access | NV Name Data Type Description of Semantics of Values 
ID | Implementation | Rule Attribute 
et 


Number of supported| Number of attributes 
attributes supported in this object 


Optional G NV |Number of USINT 
Attributes 
instance 
Optional Get NV {Attribute List |ARRAY OF |Attribute List List of attributes supported 
USINT in this object instance 


Optional See NV |Data Type USINT Determines the Data |see Semantics section 
Seman- Type of Setpoint, 
tics Process Variable 
and related attributes 
Optional See NV |Data Units ENGUNITS |Determines the See Appendix D 
Seman- context of the 
tics Process related 
variables such as 
Setpoint and Process 
Variable 


Optional Set NV |Control Mode |USINT Specifies the See Semantic section 
operational mode of [default] = Normal (0) 
the controller 

Required Set V_ {Setpoint INT or The setpoint to See Semantics section. 

specified by |which the process See Behavior section 
Data Type if |variable will be : 
controlled 0 = [default] 


Conditional * Set V_ {Process INT or The measured The device profile must 


specified by |process parameter Specify the data connection 
for this attribute. It may be 


internally linked to a 
sensor. See Semantics 
section. 

0 = [default] 


Optional Get NV |CV Data Type |USINT Determines the Data |see Semantics section 
Type of Control 
Variable 


Conditional * Get V_ {Control INT or The drive signal The device profile must 
specified by |output of this object. |Specify the data connection 
CV Data The algorithm by for this attribute. It may be 
which this attribute | internally linked to an 
is calculated is actuator. 


manufacturer [default] = 0 
specific. See Semantics section. 


Required Get V_ {Status Alarm and Warning |see Semantics section 
State of this object [default] = 0 
instance 
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Attr Need in Access | NV Name Data Type Description of Semantics of Values 
ID_ | Implementation | Rule Attribute 


11 |Optional NV Enables the setting {0 = disable [default] 
of the Alarm Status |1 = enable 
Bit 

12 NV Enables the setting {0 = disable [default] 


of the Warning 1 = enable 
Status Bit 


13 |Optional Alarm Settling Number of see Behavior section 
Time Milliseconds allowed [default] = 0 
for the control-loop 


to settle to within the 


error band 


— 
aN 


Oo Oo Oo 
aw] aw] aw] 
ec. a. a. 
° ° ° 
=) =) =) 
ab) op op 
a a a 


Z 
< 


Alarm Error The amount by see Behavior section 
Band specified by |which the Setpoint [default] = 0 

must equal the 

Process Variable 


Optional 


15 Warning Number of see Behavior section 
Settling Time Milliseconds allowed [default] = 0 

for the control-loop 

to settle to within the 


Error Band 
16 


Z 
< 


Z Z 


Warning Error The amount by see Behavior section 
Band which the Setpoint [default] = 0 

must equal the 

Process Variable 


Z 


17 |Optional Safe State USINT Specifies the Control |see Semantics section 
Variable behavior 0 = [default] 
for states other than 


Execute 


Z 


Safe Value INT or The value to be used |see Semantics section 
specified by |for Safe State = Safe |g — [default] 
Data Type if |Value 
supported 


Ramp Rate UDINT 


18 |Optional 


Set 
Set 
Set 
Set 
et 
et 
Set 
Set 
Set 


Time in Milliseconds|0 = Disabled [default] 
to reach Setpoint x = value in milliseconds 
see Behavior section 


Z 


19 |Optional a 


85-96 Defined by subclasses below. 
97-98 Reserved by CIP for Future Use 


99 |Conditional ** Get | NV |Subclass UINT Identifies a subset |0 = No subclass 
of additional 1 = PID & Source Select 
instance attributes, |2 = DC Generator 
services and 3 = RF Generator 
behaviors. 4 = Frequency Control 
5 — 65535 = Reserved 


* The Process Variable is only optional if this device includes an internal sensor. Otherwise, the Process Variable is 
required. Similarly, The Control Variable is only optional if this device includes an internal actuator. Otherwise, the Control 
Variable is required. 


** Tf the value of Subclass is 00, then this attribute is OPTIONAL in implementation, otherwise, this attribute is 
REQUIRED. 
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Subclasses 


Each instance level subclass defines a unique meaning for an overlapping range of instance 
attribute IDs and/or instance service IDs. The range for subclass definitions begins at ID 96 
and numbers downward for attributes, and ID 63;., and numbers downward for services. The 
subclass for a given instance is identified by the value of its Subclass instance attribute. The 
subclasses for this object are specified at the end of this object specification section. 


Semantics: 


Data Type 


All Data Type attributes, including Data Type and CV Data Type, use the enumerated values 
specified in Appendix C-6.1. 


The Data Type attribute is settable only in the Idle State and only if no attribute belonging to 
the object instance is the endpoint of an I/O connection in the Established State. 


The Data Type attribute may change automatically based upon established I/O connections. See 
Behavior section for more information on this mechanism. 


Data Units 


Specifies the context of Setpoint and Process Variable and related attributes (such as, offset 
and trip points) for this object instance. See Appendix D for a list of values. A request to set 
attribute to an unsupported value will return an error response. 


The Data Units attribute is settable only in the Idle State. 


In applications where this object is used in a relationship with an S-Analog Sensor object, this 
attribute may be specified as Get only, by the device profile or the vendor, where the value 
mirrors that of the S-Analog Sensor object Data Units attribute. 


Setpoint, Process Variable and Control Variable 


These three attributes compose the primary aspects of basic closed-loop control. The Process 
Variable is the measured parameter of the process or system being controlled. The Setpoint is 
the desired value for the measured parameter. By affecting the value of the Control Variable, 
the closed-loop controller drives the process or system to the desired state of: 


Process Variable = Setpoint 


The Control Variable is, therefore, connected to the process or system in such a way that it 
affects the value of the Process Variable. Examples of Control Variable / Process Variable 
combinations include: heater / temperature; valve / flow; or regulator / pressure. 
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Status 


A bit mapped byte which indicates the Alarm and Warning Exception status of the object 
instance. The following definition applies: 


Table 5-38.3 Status Attribute 


Bit Definition 
Alarm Exception: 0 = cleared; 1 = set 
Warning Exception: 0 = cleared; 1 = set 
Reserved 

Reserved 

Reserved 

Reserved 

Reserved 


NYO] OU); R[wWINMNITR|o 


Reserved 
Control Mode 


This attribute is used to override the value of the Control Variable attribute. Further, it may 
cause the object to modify the internal control algorithm such that a smooth, or “bumpless” 
transitions occurs upon activating control to setpoint. 


The Safe State attribute provides a mechanism for override depending upon object state and 
will take precedents over this. That is, if an object instance implements the Safe State attribute 
and related behavior, then this Override attribute and related behavior will only function in the 
Executing State. 


Table 5-38.4 Control Mode Attribute 


Attribute Value State 
0 Normal 
al Zero / Off / Closed 
2 Full / On / Open 
3 Hold 
4 Safe State 
5-63 reserved 
64-127 Device Specific (specified by device profile) 
128-255 Vendor Specific 
Safe State 


This attribute specifies what value will be held in the Control Variable attribute for states other 
than Executing. See the S-Device Supervisor object definition in Section 5-35. fora 
description of object states. The following values are defined: 


— 5-322 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 5 


5-38.3.7 


5-38.4 


5-38.5 


5-38.6 


5-38.6.1 


S-Single Stage Controller Object, Class Code: 33pex 


Table 5-38.5 Safe State Attribute 


Attribute Value State 
0 Zero / Off 
1 Full Scale / On 
2 Hold Last Value 
3 Use Safe Value 
4-63 reserved 
64-127 Device Specific (specified by device profile) 
128-255 Vendor Specific 
Safe Value 


For Safe State set to Use Safe Value, this attribute holds the value to which the Control 
Variable attribute will be set for object instance states other than Executing. 


Common Services 
The S-Single Stage Controller Object provides the following Common Services: 


Table 5-38.6 S-Single Stage Controller Object Common Services 


Service | Need in Implementation Service Name Description of Service 


OEhex Conditional* Required | Get_Attribute_Single Returns the contents of the specified 
attribute. 
10hex n/a Set_Attribute_Single Modifies an attribute value. 


*The Get_Attribute_Single service is REQUIRED if any attributes are implemented. 


See Appendix A for definitions of these services 
Object-specific Services 


The S-Single Stage Controller Object provides no Object—Specific services. 


Behavior 


The behavior of this object is managed by the S-Device Supervisor Object in Section 5-35.5. 
Additionally, this object exhibits the following behavior: 


Alarm and Warning Exception Conditions 


While in the Executing State as defined by the S-Device Supervisor Object: Immediately upon 
detecting that the Setpoint does not equal the Process Variable by an amount plus-or-minus the 
associated (alarm or warning) Error Band, a timer is started. This internal timer is incremented 
as long as the above condition exists. If the timer exceeds the amount indicated by the 
associated (alarm or warning) Settling Time and the associated (alarm or warning) Exception 
Enable is set, then the appropriate (alarm or warning) Exception Condition is set. Note that 
two internal timers are required in order to support both Alarm and Warning Exception 
reporting. 
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This behavior is modified for Ramp Rate values not equal to zero. In such cases, the timer is 
not enabled until after the expiration of the Ramp Time (see Behavior description below). 


Ramp Rate 


For Ramp Rate values other than zero, the S-Single Stage Controller Object internally modifies 
the Setpoint value in such a way that the Process Variable is “ramped” to its final value. For 
example: with a Ramp Rate value of 1000, a new Setpoint value will be internally 
(transparently) modified, in whatever time increments the object is able to sustain, in order to 
affect a smooth transition over one second from the old Setpoint to the new Setpoint, finally 
reaching the new Setpoint at the one second mark. 


Data Type 


If the implementation of this object specifies more than one valid Data Type value, in the 
device profile or by vendor, then the following behavior with respect to Data Type applies: The 
Data Type value will be set automatically based upon the first valid I/O connection established 
by the device. This configuration will then remain in effect for this object instance even after 
all I/O connections are lost. If, however, a device is specified by a vendor to support only one 
Data Type, this behavior is not supported. 


If no established I/O connections exist, which include an attribute from this object, then the 
Data Type attribute is settable provided that the object is in the Idle State. 


The following example demonstrates this behavior: 


A device profile specifies an instance of the S-Single Stage Controller object as well as two 
static Assembly object instances, both with data attribute components mapped to this object 
instance. Assembly object instance ID 1 specifies INT data types and Assembly object 
instance ID 2 specifies REAL data types. 


After the device is On-Line, it is configured with an I/O connection to Assembly instance 
ID 2. When the connection transitions to the Established State, this object instance attribute 
Data Type is automatically set with the value for REAL before any data is communicated 
to, or from, the object instance. 


Control 


The application of this object is further specified in the applicable device profile; primarily, the 
interfaces and object relationships are defined. Generally, the Process Variable attribute is 
restricted to "Get Only" access and an internal connection is defined to another object. 
Similarly, the Control Variable is generally not supported due to internal connections. 


When in the EXECUTING state, this object is running an application process designed to cause 
the Process Variable to be driven to the value of the Setpoint. In any state other than 
EXECUTING, the application process is stopped and the Safe State is activated for the output 
of the object. 


Any fault detected by the object application process causes the object to transition to the 
appropriate state as defined by the managing S-Device Supervisor object. 
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S-Single Stage Controller Object Instance Subclass 01 - (PID and 
Source Select) 
The following specification applies to an instance subclass of this object. The intended 
applications of this subclass include cases where: PID (Proportion, Integral, Derivative) Servo 


Control algorithms are utilized and/or more than one Process Variable Source is connected. A 
typical application for the object instance subclass is that of a Pressure Control Valve. 


Instance Attributes 


The following Instance Attributes are specific for this subclass. 


Table 5-38.7 PID and Source Select Subclass Instance Attributes 
Attr Need in Access | NV Name Data Description of Semantics of Values 
ID | Implementation | Rule Type Attribute 

87 Calibrating BOOL [Indicates whether or |0 = Not CALIBRATING 


not the object is in the |1 = CALIBRATING 


CALIBRATING state |[default] = 
89 |Conditional ** 


rT Delay Time UINT Defines the time Time in milliseconds 
90 |Conditional ** iV 


State 


Z 
< 


Crossover High ifi point between High to |specific 
Low range inputs. see Behavior section 
see Semantics section 


Sensor Defines the crossover |[default] = manufacturer 
Crossover Low ifi point between Low to |specific 

High range inputs. see Behavior section 
see Semantics section 


Z 
< 


Expected Used to optimize [default] = manufacturer 
Process specified |control function specific 


Parameter 

REAL Derivative Gain [default] = manufacturer 
REAL Integral Gain [default] = manufacturer 
REAL Proportional Gain [default] = manufacturer 


Control BOOL Defines control 0 = Direct 
Direction direction as Direct or |(Downstream Control) 
Reverse 1 = Reverse 
(Upstream Control) 
[default] = 0 
see Behavior section 
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Sensor Defines the crossover |[default] = manufacturer 
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Attr Need in Access | NV Name Data Description of Semantics of Values 
ID | Implementation] Rule Type Attribute 


96 |Optional Set | NV |Process Source of the Process |0 = Network 
Variable Source Variable value for the |1 = S-Analog Sensor 
process control object instance #1 
function 2 = S-Analog Sensor 
object instance #2 
3 = Auto 
4 = Disable 
5-255 = Reserved by CIP 
[default] = 1 
see Behavior section 


* Required if Calibrating service is supported, otherwise, not required. 


** Required if Process Variable Source type 3 is supported, otherwise, not required. 
Semantics 


Calibrating State 


Indicates the state of the object instance. 


Delay Time 
Specifies the required time of the presence of the Sensor Crossover condition to be true before 
changing the Process Variable source. See Behavior section for more information. 

Sensor Crossover High, Low 
Specifies the value of the Process Variable, in percent, that allows automatic switching to the 
other Process Variable Sources. See Behavior section for more information. 

Expected Process Parameter 


Specifies a value for a process parameter that may be applied to the control application process 
to optimize the control of the Process Variable. The context of this attribute is defined by the 
application. For example, a Pressure Control Valve application may define this attribute to 
specify the expected Flow Rate through the valve. 


Kd,Ki,Kp 
Specifies the values of a PID control loop. This gives access to adjusting the parameters of the 
control function for the Process Variable. 


Control Direction 


This defines the polarity for control of the process variable. The control mechanism can then 
be knowledgeable of what effect increasing or decreasing the Control Variable will have on the 
Process Variable. See Behavior section for more information. 


Process Variable Source 


The Process Variable Source specifies the source of the measured value, or the process 
variable, being controlled. See Behavior section for more information. 
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If the Process Variable Source equals zero indicating a Network source, the value of the 
Process Variable attribute will be updated across a network connection. Sensor Crossover 
parameters are not used, nor may any automatic switching of the Process Variable Source 
occur. 


If the Process Variable Source equals one or two, the value of the Process Variable attribute is 
fed by the corresponding S-Analog Sensor object Value attribute. Sensor Crossover parameters 
are not used nor, may any automatic switching of the Process Variable Source occur. 


If the Process Variable Source equals three, the value of the Process Variable attribute is fed by 
either the low-range or the high-range S-Analog Sensor object Value attribute. In order for 
three to be a valid attribute value for the Process Variable Source, two S-Analog Sensor 
instances are required. Selection of the appropriate S-Analog Sensor instance is performed by 
the device, and defined by the Sensor Crossover High and Sensor Crossover Low attribute 
values defined below. 


Instance 1 for the Process Variable Source S-Analog Sensor is taken as the low range and also 
is the required instance for direct input when only one Process Variable Source is attached to 
the device. Instance 2 is taken as the high range, defining this as a higher magnitude above the 
low range. 


NOTE: The capability of each device to accurately resolve a particular high range or low range 
sensors must be specified by the manufacturer. Inappropriate selection of high and low range 
sensors needs to be addressed in application guides for usage of the device. Care must be given 
to the compatibility of these ranges to avoid unsatisfactory behavior. 


A value of 4 for the Process Variable Source supports device configurations where no process 
variable exists for this instance. This value prevents action by the controller until configured 
with a valid Process Variable Source. 


Services 


The following Services are specific for this subclass. 


Table 5-38.8 PID and Source Select Subclass Services 


Service Need in implementation Service Name Description of Service 


63hex na Optional Calibrate Moves the device to the Calibrating 
state. This service may also end a 
calibration that is in process. 
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5-38.7.3.1 Calibrate 


Used to transition this object to the CALIBRATING substate of the EXECUTING state. Refer 
to the Behavior section for a description of the CALIBRATING state. This service may also 
end a calibration procedure that is in process. 


Table 5-38.9 Calibrate Request Service Data Field Parameters 


Command USINT Specifies whether to start or | 0 = Stop Calibration 
stop the calibration 1 = Start Calibration 


5-38.7.4 Behavior 


The following additional behavior is specific for this object instance subclass. 


Figure 5-38.10 Object State Transition Diagram 


\ EXECUTING Start Calibration 
Request 


CONTROLLING CALIBRATING 


Calibration Completed, 
or Stop Calibration 
Request 


Table 5-38.11 State Descriptions 


State 


Description 


CONTROLLING | The object is running an application process designed to position the control 
valve such that the Process Variable is driven to equal the Setpoint. 


CALIBRATING | The object is running a manufacturer-specific calibration process. This 


process may involve an algorithm designed to characterize the system in order 
to improve the quality of control. 


Table 5-38.12 Object State Event Matrix 


EVENT Controlling Calibrating 
Start Calibration Transition to Error AIRS* 
Request CALIBRATING 
Stop Calibration Request Error AIRS* Transition to 
CONTROLLING 
Calibration Complete Transition to 
CONTROLLING 


* Error AIRS = Error Response - Already in Requested Mode/State 
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Process Variable Input Switching 


The Sensor Crossover High/Low Variable values for each Process Variable Source defines the 
value to change to the other Process Variable source. This is only valid with the Process 
Variable Source Attribute set to automatic (3), which can only be valid with the presence of 
two Process instances. 


Delay Time 


The Delay Time timer is used to minimize unnecessary switching of the Process Variable 
Source when more than one source is available and automatic switching is selected. The Delay 
Time shall be held in reset when the condition for Sensor Crossover is false, and starts when 
the condition is true. After starting to count, the Delay Time resets anytime the condition is not 
true. The Delay Time also resets after a switch has occurred. 


Sensor Crossover Low 


This parameter is only used when there are two instances of the S-Analog Object for Process 
Variable Sources and the value of the Process Variable Source is 3. It specifies the value of the 
Process Variable that allows the device to switch automatically from the Process Variable 
Source instance 1 to instance 2. Its value is valid only in the range of the instance 1 S-Analog 
Sensor. To rephrase this, this variable describes a value when to automatically switch from the 
low to high range of Process Variable Sources. Specifying a value outside the range of the low 
range sensor is not allowed. 


Sensor Crossover High 


This parameter only used when there are two instances of the S-Analog Object for Process 
Variable Sources and the value of the Process Variable Source is 3. It specifies the value of the 
Process Variable that allows automatic switching from the Process Variable Source instance 2 
to instance 1. Its value is valid only in the range of the instance 2 S-Analog Sensor. To rephrase 
this, this variable describes a value when to automatically switch from the high to low range of 
Process Variable Sources. Specifying a value outside the range of the high range sensor is not 
allowed. 


Control Direction 


Direct-Acting Controller — as the Process Variable increases, the Control Variable increases 
(and visa versa). For example, where this object instance subclass is applied to a variable 
conductance valve downstream of a pressure control process (downstream pressure control); an 
increase in pressure (Process Variable) causes an increase in valve opening (Control Variable) 
resulting in a commensurate decrease in pressure, whereby, the pressure is maintained at 
Setpoint. 


Reverse-Acting Controller — as the Process Variable increases, Control Variable decreases 
(and visa versa). Referencing the above example (Direct-Acting Controller), this configuration 
would apply to a variable conductance valve upstream of a pressure control process (upstream 
pressure control). 
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Process Variable Source 


If the Process Variable Source equals zero indicating a Network source, the value of the 
Process Variable attribute will be updated across a network connection. Sensor Crossover 
parameters are not used, nor may any automatic switching of the Process Variable Source 
occur. 


If the Process Variable Source equals one or two, the value of the Process Variable attribute is 
fed by the corresponding S-Analog Sensor object Value attribute. Sensor Crossover parameters 
are not used nor, may any automatic switching of the Process Variable Source occur. 


If the Process Variable Source equals three, the value of the Process Variable attribute is fed 
by either the low-range or the high-range S-Analog Sensor object Value attribute. In order for 
three to be a valid attribute value for the Process Variable Source, two S-Analog Sensor 
instances are required. Selection of the appropriate S-Analog Sensor instance is performed by 
the device, and defined by the Sensor Crossover High and Sensor Crossover Low attribute 
values defined below. 


Instance 1 for the Process Variable Source S-Analog Sensor is taken as the low range and also 
is the required instance for direct input when only one Process Variable Source is attached to 
the device. Instance 2 is taken as the high range, defining this as a higher magnitude above the 
low range. 


NOTE: The capability of each device to accurately resolve a particular high range or low range 
sensors must be specified by the manufacturer. Inappropriate selection of high and low range 
sensors needs to be addressed in application guides for usage of the device. Care must be given 
to the compatibility of these ranges to avoid unsatisfactory behavior. 


A value of 4 for the Process Variable Source supports device configurations where no process 
variable exists for this instance. This value prevents action by the controller until configured 
with a valid Process Variable Source. 
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S-Single Stage Controller Object, Class Code: 33pex 


S-Single Stage Controller Instance Subclass 02 - DC Generator 


The following specification applies to a subclass of this object for application in DC Power 
Generator devices such as those used to create plasma energy. 


Instance Attributes 


The following Instance Attributes are specified for this object subclass. 


Table 5-38.13 DC Generator Subclass Instance Attributes 


nae Need in Access Name Data Type} Description of Attribute | Semantics of Values 
Implementation | Rule 
85 |Optional NV {Output Max |DINT Factory set Device Watts, Volts or 
Capability milliAmps as Specified 
see Below by Data Units attribute 
(ID 4) 
Optional Set NV {Output Limit} DINT i imi i : 
see Below milliAmps as Specified 
by Data Units attribute 
dD 4) 


Pe ee 


Optional Vv Number of arcs detected {Counts 
since Output Power was 
last started 
Set NV_ |Pulse Enable |BOOL Enables the Pulse 0 = Disable [default] 
Application Process 1 = Enable 
See Below 
Conditional* NV_ |Pulse INT or The setpoint value for the |Watts, Volts or 
Second specified by |second half of a pulse milliAmps as Specified 
Setpoint Data Type |period by Data Units attribute 
if supported (ID 4) 
[default] = 0 
Conditional* NV_ {Pulse Period |DINT The duration of one microseconds 
Duration complete on/off cycle 
Conditional* NV_ {Pulse Duty |UINT The percentage of the Pulse 
Period for which the 
setpoint is at its normal 
value 
Optional NV_ |Sync Enable |BOOL Enables an external 0 = Disabled [default] 
synchronizing signal to 1 = Enabled 
begin a Pulse Period 


Desired limit of the Device |Watts, Volts or 


Arc Trip DINT Output voltage level which | Volts 
Level determines an arc condition 
NV Number of arcs that create {Counts 
imi an Arc Limit Exceeded [default] = 


Warning Condition 


Optional Set Sync Phase |DINT Specifies a delay between |microseconds 
Delay the sync signal and 
beginning of the Pulse 
Period 
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Need in 
Implementation 


Optional Set NV_ |Ramp Rate 
0 - 100% Setpoint per 
Second 
0 = Disabled [default] 


Attr 
ID 


* Required if Pulsed Power Delivery is supported 


5-38.8.2 Semantics 


5-38.8.2.1 Output Max 


This is a factory set specification of the capability of the device. The context of the attribute is 
determined by the value of the Data Units attribute (ID 4). Depending upon the use of this 
Object Instance, this value specifies the maximum, Output Power, Output Voltage or Output 
Current. 


5-38.8.2.2 Output Limit 


This attribute is set by the user to limit the output. The device shall not deliver any output 
beyond this value. The context of the attribute is the same as that of the Output Max attribute 
above. A request to set this attribute beyond the value of Output Max returns an Invalid 
Attribute Value error. 


5-38.8.2.3 Ramp Rate Increment 


Upon receiving a new setpoint value for output power, the S-Single Stage Controller Object 
instance will internally ramp to the new setpoint value as specified by the Ramp Rate Increment 
attribute. For a Ramp Rate Increment value of zero, the ramping is disabled and the new 
setpoint takes effect immediately or as determined by the time based Ramp Rate attribute (ID 
19) value. Otherwise, the Ramp Rate Increment behavior overrides that of the time based 
Ramp Rate. 


For values in the range of 1-4095, corresponding to the range of 2.442 x 10* % to 100 %, the 
setpoint is ramped at a rate equal to the percentage of the difference between the initial setpoint 
and the new setpoint per second (e.g., 50% specifies half the difference). 


For example: Ramp Rate = 2047 (50%); initial setpoint = 75% of Full Scale; new setpoint = 
100% of Full Scale. Results: effective setpoint ramps from 75% to 100% of Full Scale at the 
rate of 12.5% of Full Scale per second and reaching final value in 2 seconds. 


5-38.8.3 Services 


There are no additional services defined for this subclass 
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S-Single Stage Controller Object, Class Code: 33pex 
Behavior 


Pulse Application Process 


The Pulse Application Process causes the S-Single Stage Controller Object Instance to behave 
as though its setpoint attribute is periodically switching between two values. The first value is 
that which is set to the Setpoint attribute. The second value is that which is set to the Pulse 
Second Setpoint attribute. 
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S-Single Stage Controller Object, Class Code: 33pex 


S-Single Stage Controller Instance Subclass 03 - RF Generator 


The following specification applies to a subclass of this object for application in RF Power 
Generator devices such as those used to create plasma energy. 


Instance Attributes 


The following Instance Attributes are specified for this object subclass. 


Table 5-38.14 RF Generator Subclass Instance Attributes 


Attr Need in Access | NV Name Data Type Description of Semantics of Values 

ID |Implementation| Rule Attribute 

88 |Optional Get NV |Output Max DINT Factory set Device Watts, milliWatts, Volts or 
Capability milliAmps as Specified by 
see Below Data Units attribute (ID 4) 

89 |Optional Set NV |Output Limit |DINT Desired limit of the Watts, milliWatts, Volts or 
Device milliAmps as Specified by 
see Below Data Units attribute (ID 4) 


90 |Conditional* Set NV |Pulse Enable |BOOL Enables the Pulse 0 = Disable [default] 
Application Process 1 = Enable 
S 


ja 


3 


: 


[default] = 0 


NV |Pulse Period |DINT The duration of one microseconds 
Duration complete on/off cycle 
NV UINT The percentage of the 
Pulse Period for which 
the setpoint is at its 
normal value 
NV |Sync Enable |BOOL Enables an external 0 = Disabled [default] 
synchronizing signal to |1 = Enabled 
begin a Pulse Period 


iJ 
To 


DINT Specifies a delay microseconds 

between the sync signal 

and beginning of the 

Pulse Period 
Ramp Rate UINT Specifies a setpoint Range = 0 to 4095 
Increment ramp as described 0 - 100% Setpoint per 

below Second 
0 = Disabled [default] 


* Required if Energy Control is supported 
** Required if Target Life tracking is supported 
*** Required if Pulsed Power Delivery is supported 
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5-38.9.2. Semantics 


5-38.9.2.1 Output Max 


This is a Factory set specification of the capability of the device. The context of the attribute is 
determined by the value of the Data Units attribute (ID 4). Depending upon the use of this 
Object Instance, this value specifies the maximum, Output Power or Delivered Power. 


5-38.9.2.2 Output Limit 


This attribute sets the limit beyond which the device will not operate. The context of the 
attribute is the same as that of the Output Max attribute above. A request to set this attribute 
beyond the value of Output Max returns an Invalid Attribute Value error. 


5-38.9.2.3 Ramp Rate Increment 


Upon receiving a new setpoint value for output power, the S-Single Stage Controller Object 
instance will internally ramp to the new setpoint value as specified by the Ramp Rate Increment 
attribute. For a Ramp Rate Increment value of zero, the ramping is disabled and the new 
setpoint takes effect immediately or as determined by the time based Ramp Rate attribute (ID 
19) value. Otherwise, the Ramp Rate Increment behavior overrides that of the time based 
Ramp Rate. 


For values in the range of 1-4095, corresponding to the range of 2.442 x 10 % to 100 %, the 
setpoint is ramped at a rate equal to the percentage of the difference between the initial setpoint 
and the new setpoint per second (e.g., 50% specifies half the difference). 


For example: Ramp Rate = 2047 (50%); initial setpoint = 75% of Full Scale; new setpoint = 
100% of Full Scale. Results: effective setpoint ramps from 75% to 100% of Full Scale at the 
rate of 12.5% of Full Scale per second and reaching final value in 2 seconds. 


5-38.9.3 Services 


There are no additional services defined for this subclass. 


5-38.9.4 Behavior 


5-38.9.4.1 Pulse Application Process 


The Pulse Application Process causes the S-Single Stage Controller Object Instance to behave 
as though its setpoint attribute is periodically switching between two values. The first value is 
that which is set to the Setpoint attribute. The second value is that which is set to the Pulse 
Second Setpoint attribute. 
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5-38.10 S-Single Stage Controller Instance Subclass 04 - Frequency Control 


The following specification applies to a subclass of this object for application in RF Power 
Generator devices such as those used to create plasma energy. 


5-38.10.1 Instance Attributes 


The following Instance Attributes are specified for this object subclass. 


Table 5-38.15 Frequency Control Subclass Instance Attributes 


Attr Need in Access | NV Name Data Type | Description of Semantics of Values 
ID | Implementation | Rule Attribute 
92 Optional Get | NV |Minimum DINT Factory Set Hertz 
Frequency 
93 Optional Get | NV |Maximum DINT Factory Set Hertz 
Frequency 
94 Optional Set | NV |Default DINT Factory Set Hertz 
Frequency 
N T 


~ Optional Set | NV |Frequency {DIN Limits the Output | Hertz 
imi Frequency of the 
device May not be set beyond 
Min Frequency 


96 Optional Limits the Output —_| Hertz 
Frequency of the 
device May not be set beyond 
Max Frequency 


5-38.10.2 Semantics 


5-38.10.2.1. Minimum, Maximum and Default Frequency Attributes 


Minimum, Maximum and Default Frequency attributes specify the capabilities of the device. 


5-38.10.2.2. Frequency Limit High and Low Attributes 


Limit attributes allow the user to set bounds beyond which the device will not operate. A 
request to set a limit attribute or the default attribute beyond the bounds of a specified Min or 
Max value will return an Invalid Attribute Value error. 


5-38.10.2.3 Setpoint 


A Setpoint value of zero causes the S-Single Stage Controller object instance to perform the 
Auto-tune Application Process. Any other value of setpoint (within specified limits) causes the 
S-Single Stage Controller object instance to perform the Frequency Control Application 
Process. 


Data Type = DINT 


Data Units = Hertz 
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5-38.10.3 Services 


There are no additional services defined for this subclass. 


5-38.10.4 Behavior 


5-38.10.4.1 Frequency Control Application Process 


This application process controls the output frequency to the set value as specified by the 
Setpoint attribute of this object instance. 


5-38.10.4.2 Auto-tune Application Process 


This application process controls the output frequency in order to affect optimum power 
delivery efficiency in RF Power Generator devices. The vendor specific algorithm tunes the 
output frequency in order to minimize Reflected Power for the device's application. 
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S-Gas Calibration Object 
Class Code: 34Hex 


An S-Gas Calibration Object affects the behavior of an associated S-Analog Sensor object 
instance; a device profile will show a relationship between these two objects where an S-Gas 
Calibration Object is used. The S-Analog Sensor object uses a selection attribute as the gas 
type selection mechanism. The S-Gas Calibration Object provides the data with which a device 
enacts the appropriate calibration algorithm for a given gas type. Each S-Gas Calibration 
Object Instance contains a set of attribute values for one particular calibration set; each 
identified by the Gas Standard Number. 


The S-Gas Calibration class level object provides a service for retrieving a list of all valid 
object instances. The service response includes a list of elements. Each element includes: 
Instance ID, Gas Standard Number and the valid S-Analog Sensor object instance ID for which 
the instance is valid. 


There may be more than one instance with the same Gas Standard Number. These instances 
may be differentiated by Full Scale, Gas Symbol, Additional Scaler and/or other parametric 
distinctions, including valid S-Analog Sensor object instance ID. The distinctions may, or may 
not, be evident in the Get_All_Instances service response, depending upon what the distinction 
is. 

S-Gas Calibration Objects most often utilize the region of Manufacturer Specified Attributes 


(ID > 100) for specific calibration parameters. 


This object is a member of the Hierarchy of Semiconductor Equipment Devices. As such, its 
behavior is managed by the Device Supervisor Object. See Section 5-35. 


The S-Gas Calibration object makes use of a list of Standard Gas Type Numbers. This list is 
described in publication: 


SEMI E52-95 “Practice for Referencing Gases Used in Digital Mass Flow Controllers”, 
Semiconductor Equipment and Materials International (SEMI), Mountain View, CA 94043- 
4080. 


NOTE: It is implied that the reference above is to the latest revision as specified by SEMI. 
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S-Gas Calibration Object, Class Code: 34x 


Class Attributes 


Table 5-39.1 S-Gas Calibration Object Class Attributes 


Attribute Need in Access Name Data Type Description of Attribute 
ID implementation | Rule 


1 thru 7 | These class attributes are optional and are described in Chapter 4 of this specification. 


Reserved by CIP for Future Use 


- 


* Tf the value of Subclass is 00, which identifies "no subclass", then this attribute is OPTIONAL in 
implementation, otherwise, this attribute is REQUIRED. 


Identifies a subset of additional 
class attributes, services and 
behaviors. 


Subclasses 


Each class level subclass defines a unique meaning for an overlapping range of class attribute 
IDs and/or class service IDs. The range for subclass definitions begins at ID 96 and numbers 
downward for attributes, and ID 63). and numbers downward for services. The subclass for a 
given class is identified by the value of its Subclass class attribute. The subclasses for this 
object are specified at the end of this object specification section. 


Instance Attributes 


Certain minimal implementations may support any optional “Set” attributes as “Get” only and 
still be compliant with this object specification. All required attributes must be supported as 
specified. 


Table 5-39.2 S-Gas Calibration Object Instance Attributes 


USINT Number of attributes 
supported 


USINT supported by this 
object instance 


Semantics of Values 


Gas Standard |UINT Gas Type Number [default] = 0 (no gas 
Number type specified) 
see Semantics section 


Valid Sensor |UINT S-Analog Sensor 0 = No Valid Sensor 
Instance object instance ID for |n = Instance ID 


which this object see Semantics section 
instance is valid [default] = 0 

see Semantics section 
[default] = null 
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Attr Need in Access | NV Name Data Type Description of Semantics of Values 
ID Implem Rule Attribute 
6  |Optional Set* |NV_ |Full Scale STRUCT of: |Full Scale of the see Semantics section 
device using this [default] = 0, 0 
object instance ; 

REAL Amount The amount of 
measured parameter 
corresponding to full 
scale. 


ENGUNITS |Units The units for the 
above. See Data Units 
Appendix D 
7 |Optional NV |Additional 


Additional Correction |In addition to the 
Factor correction algorithm, 
this amount is 
multiplied to the 
reading. Generally 
used for Gas 
Correction for a gas 
other than the type 
identified for the 
object instance by 
attribute 3. 


(e.g., scale a nitrogen 
object instance to 
measure argon). 


Default = 1.0 


REAL 
8 |Optional NV |Calibration DATE Date of Calibration |The date this object 
instance was last 


calibrated 
[default] = 0 


NV |Calibration 
Gas Number 


Optional UINT 


10 [Optional NV 


95-96 |Defined by Subclasses below 
97-98 |Reserved by CIP for Future Use 
99 |Conditional ** |Get NV _ |Subclass UINT 


Calibration Gas The gas number of the 
gas used to calibrate 
this object instance. 


[default] = 0 


Set 
Get 
Get 
et Gas Correction} REAL 


Factor 


Gas Correction Factor |[default] = 1.0 


For devices that 
support simple 
correction factors (as 
opposed to 
algorithms) for gas 
selection. 


oo 


Identifies a subset of |0 = No subclass 
additional instance 1 = Standard T & P 


attributes, services 
2 — 65535 = Reserved 


and behaviors. 


* Tf this attribute is supported, Set Access is optional. 
** Tf the value of Subclass is 00, then this attribute is OPTIONAL in implementation, otherwise, this attribute is 
REQUIRED. 
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S-Gas Calibration Object, Class Code: 34x 


Subclasses 


Each instance level subclass defines a unique meaning for an overlapping range of instance 
attribute IDs and/or instance service IDs. The range for subclass definitions begins at ID 96 
and numbers downward for attributes, and ID 63;., and numbers downward for services. The 
subclass for a given instance is identified by the value of its Subclass instance attribute. The 
subclasses for this object are specified at the end of this object specification section. 


Semantics: 


Gas Standard Number 


Used to identify a gas standard number, for which the object instance is currently calibrated. 
See Instance Application Example below. 


The actual coding of the values are described in the following publication: 


See introduction section (above) for reference to the SEMI publication: “Practice for 
Referencing Gases Used in Digital Mass Flow Controllers”. 


Since the actual attributes, and their context, for the parameterization of object instances for 
particular gas types is beyond the scope of this standard (i.e., vendor specific) the Access Rule 
for this attribute has been specified as Get. Vendors may choose to specify an Access Rule of 
Set for this attribute. 


Valid Sensor Instances 


This attribute specifies the S-Analog Sensor object instance for which the S-Gas Calibration 
object instance is valid. An S-Gas Calibration object instance will be valid for zero or one S- 
Analog Sensor object instances. 


Gas Symbol 


This optional attribute is a string coded representation of the name of the gas for which the 
object instance has been configured. It is coded as a user defined text symbol or it is coded as 
defined in the above referenced SEMI publication. 


This attribute may indicate a different gas from the one which has been specified by the Gas 
Standard Number. See Instance Application Example below. 


Full Scale 


This optional attribute identifies the amount of measured parameter (e.g., Mass Flow) 
corresponding to the Full Scale of the associated S-Analog Sensor object. A primary purpose 
for this attribute is to allow for simple S-Analog Sensor object implementations where the 
Value is reported in raw units; this attribute allows a mapping to engineering units. 


For example, the Full Scale for a S-Gas Calibration object may be 100 sccm, while the Full 
Scale for the associated S-Analog Sensor object may be 20,000 counts (i.e., S-Analog Sensor 
object Data Type = INT and Data Units = Counts). 
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5-39.5 


S-Gas Calibration Object, Class Code: 34x 


Instance Application Example 


The following is an example to demonstrate the usage of Gas Calibration object instances and 
their attributes: 


A device has been supplied with three gas calibration object instances: nitrogen (13)2, helium 
(1) and argon (4). The user wishes to use the device for silane (39) and knows that a correction 
factor of 0.60 will properly convert a nitrogen calibration for this application. The object 
instance for nitrogen would be selected and the Additional Scaler attribute for this instance 
would be set to 0.60. To identify this modification, the Gas Symbol may be set to read 
“silane”, “SiH4”, or “39”. 


Common Services 


The S-Gas Calibration Object provides the following Common Services: 


Table 5-39.3 S-Gas Calibration Object Common Services 


Service | Need in Implementation Service Name Description of Service 


OEhex Get_Attribute_Single Returns the contents of the specified 
attribute. 


10hex Set_Attribute_Single Modifies an attribute value. 


See Appendix A for a description of these services 


Object-specific Services 


Table 5-39.4 S-Gas Calibration Object-specific Services 


Service Need in Implementation Service Name Description of Service 


4Bhex Required n/a Get_All_Instances Requests a list of all available object 
instances with their respective gas 
numbers 


Table 5-39.5 Success Response Service Data Field Parameters 


Parameter Data Type Semantics of Values 


Number of gas calibrations 


Size of List Required UINT Specifies the number of 

elements in the Array in the list 
List of Gas Required if | ARRAY of Supported List The list of gas calibrations 
Calibrations | Size >0 


STRUCT of | Supported Gas Type 


UINT S-Gas Calibration Object 
Instance ID 


UINT Gas Standard Number 


2 The number used with element names shown here is the Gas Standard Number 
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i 4 UINT Valid Sensor Instance 


S-Gas Calibration Object Behavior 


The behavior of this object is managed by the Device Supervisor Object, defined in Section 5- 
35.5. 


S-Gas Calibration Object Instance Subclass 01 (Standard T & P) 


The following specification applies to a subclass of this object for application in Mass Flow 
Controller devices. 


Instance Attributes 


The following Instance Attributes are specified for this object subclass 01. 


Table 5-39.6 Standard T & P Subclass Instance Attributes 


Attr Need in Access Name Data Type Description of | Semantics of Values 
ID Implementation Rule Attribute 


95 | Optional Get Calibration REAL The gas pressure in | The Standard 
Pressure KiloPascal Pressure with respect 
to the calibration 
conditions. 
Default = 101.32 
96 | Optional Get Calibration REAL The Gas The Standard 
Temperature Temperature in Temperature with 
Degrees C respect to the 
calibration 
conditions. 
Default = 0.0 


Services 
There are no additions or restrictions to the Object Services for this object subclass. 


Behavior 


There are no additions or restrictions to the Behavior for this object subclass. 
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Trip Point Object 
Class Code: 35 yx 


The Trip Point Object models the action of trip points for a device, often corresponding to 
physical outputs (Discrete Output Object). Each Trip Point instance has a source pointer (an 
attribute of data type Packed EPATH referencing an input value) and a destination pointer (an 
attribute of data type Packed EPATH referencing a discrete output value). A trip point value, 
designated as a High or Low trip point, is compared to the specified source value. This trip 
point is intended to be used as a process control indicator. 


Class Attributes 


Table 5-40.1 Trip Point Object Class Attributes 


Need in Access Name Data Type 
Implementation | Rule 


These class attributes are optional and are described in Chapter 4 of this specification. 
Reserved by CIP 


7 


* Tf the value of Subclass is 00, then this attribute is OPTIONAL in implementation, otherwise, this attribute 
is REQUIRED. 


Attribute 
ID 


1 thru 7 


Description of Attribute 


Identifies a subset of additional 
attributes, services and 

behaviors. The subclasses for an 
object are specified at the end of 
the object specification section. 


Subclasses 


Each class level subclass defines a unique meaning for an overlapping range of class attribute 
IDs and/or class service IDs. The range for subclass definitions begins at ID 96 and numbers 
downward for attributes, and ID 63), and numbers downward for services. The subclass for a 
given class is identified by the value of its Subclass class attribute. The subclasses for this 
object are specified at the end of this object specification section. 


Instance Attributes 


Table 5-40.2 Trip Point Object Instance Attributes 
Attr Need in Access | NV Name Data Type Description of Semantics of 
ID Implementation | Rule Attribute Values 

1 Optional Get NV |Number of | USINT Number of attributes 
Attributes supported 

2 Optional Get NV __ | Attribute ARRAY OF | List of attributes 
List USINT supported by this 

object instance 


3 Conditional Set NV_ |HighTrip | INT or based | Defines the Value at | [default = 0] 
[At least one of Point Data Type or above which a trip | see Semantics 


attributes 3 or 5 attribute, if | point condition will section 
supported. occur 


are required. ] 
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Attr Need in Access | NV Name Data Type Description of Semantics of 
ID_ | Implementation | Rule Attribute Values 


4 Optional Set NV |HighTrip }|BOOL Enables the High [default=enabled] 
Enable Trip Point setting. See Semantics 
section 
NV 


5 Conditional Low Trip INT or based | Defines the Value at | [default=0] 

Point Data Type or below which a trip | see Semantics 
attribute, if | point condition will 
supported. 


[At least one of 


attributes 3 or 5 section 


are required. ] 


occur 


6 Optional Set NV |LowTrip |BOOL Enables the Low Trip | [default=enabled] 
Enable Point setting. See Semantics 
section 
7 Required Get Vv Status BOOL State of this object 0 = trip point 
instance condition does 
not exist 
(unasserted) 
1 =trip point 
condition exists 
(asserted) 
See Semantics 
section 
8 Optional Set NV | Polarity BOOL Polarity of Output as_|0 = Normal 
derived to Status. (Output = Status) 
1 = Reverse 
(Output = Status 
inverted) 
See Semantics 
section 
9 Optional Set NV | Override USINT Specifies an override | 0 = Normal 
Status. 1 = Force FALSE 
Note: This attribute SRubassenen 
may also be set 2 = Force TRUE 
internally by the or asserted 
device during 3 = Freeze Status 
different States. and Output at 
existing values 
4-255 = 
Reserved by CIP 
10 | Optional Set NV_ | Hysteresis | Same as Determines the See Semantics 
High/Low amount by which the | section 
Point Data | Input must recover to [default=0] 
Type clear a trip point 
condition 
11 | Optional Set NV_ | Delay UINT Specifies the amount | Time in 
of time a trip milliseconds 
condition must exist | see Semantics 
before it is reported | caction 
to Status 
[default=0] 
12 | Required Set NV _ | Destination | Packed Specifies the path of | See Semantics 
EPATH the destination 
attribute whose value 
will be set by Output 
25-345 
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Trip Point Object, Class Code: 354¢ex 
Attr Need in Access | NV Name Data Type Description of Semantics of 
ID_ | Implementation | Rule Attribute Values 
13 | Required Get Vv Output BOOL Output of the object |= Status as a 
the value of which is | function of 
sent to destination Polarity 
See Semantics 
14 | Required Set NV_ | Source Packed Specifies the path of | See Semantics 
EPATH the source attribute 
whose value is 
retrieved for Input 
15 | Required Set Vv Input Input to the object See Semantics 
specified by | whose value is 
retrieved from source 
16 | Optional Get NV_ | Data Units | ENGUNITS | Units of Input, Trip | See Semantics 
Point, Hysteresis, etc. 
17 | Optional Get NV_ |DataType | USINT Data Type of Input, | [default] = INT 
Trip Point, Hyseresis, | cop Semantics 
etc. 


97 - 98 | Reserved by CIP 


99 | Conditional Get NV_ | Subclass UINT Identifies a subset of |0= No subclass 
additional attributes, |, = subclass as 
services and defined herein 
behaviors. The 
subclasses for this 
object are specified at 
the end of this object 
specification section. 


5-40.2.1 Subclasses 


Each instance level subclass defines a unique meaning for an overlapping range of instance 
attribute IDs and/or instance service IDs. The range for subclass definitions begins at ID 96 
and numbers downward for attributes, and ID 63;., and numbers downward for services. The 
subclass for a given instance is identified by the value of its Subclass instance attribute. The 
subclasses for this object are specified at the end of this object specification section. 


5-40.3 Semantics 


5-40.3.1 High/Low Trip Point, Enable and Status 


High or Low Trip Point is compared to the Input value to generate a trip point condition. 


If a single trip point for this instance is required, either the High or Low Trip Point may be 
enabled, determining not only the direction of the trip point, but also the direction of hysteresis. 
If two or more separate trip points are required, each exhibiting a separate Status, then two or 
more instances of this object are required. 


A trip region can be established with only one instance by enabling both High and Low 
settings. Status will be set if the input value is at or below the Low Trip Point OR at or above 
the High Trip Point, cleared if the input value lies between the trip points. 
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5-40.3.2 


5-40.3.3 


5-40.3.4 


Trip Point Object, Class Code: 35yex 


Hysteresis and Delay 


The Delay value specifies how long the trip condition must exist or clear before it is reported in 
Status. The Hysteresis value specifies the amount by which the Input value must transition in 
order to clear a trip point condition. 


The following relationships demonstrate the logic for a High Trip Point with Hysteresis and 
assume the use of an internal Timer: 


For Status not set: 
If (Input >= Trip Point High) and (Timer not running) 
Then start a Timer 


If (Input >= Trip Point High) and (Time >= Delay) 
Then set Status 

If (Input < Trip Point High - Hysteresis) and (Time < Delay) 
Then reset Timer 


For Status set: 

If (Input < Trip Point High - Hysteresis) and (Timer not running) 
Then start a Timer 

If (Input < Trip Point High - Hysteresis) and (Time >= Delay) 
Then clear Status 

If (Input >= Trip Point High) and (Time < Delay) 
Then clear Status 


Example: High Trip Point = 100, Hysteresis = 2, and Delay = 1000: will result in a trip point 
condition being set when the Input stays at or above 100 for 1 second and cleared when Input 
drops below 98 for 1 second. Similarly: Low Trip Point = 100, Hysteresis = 2, and a Delay = 
1000: will result in a trip point condition being set when Input falls at or below 100 for 1 
second and cleared when Input increases above 102 for 1 second. 


Data Type and Data Units 


Specifies the context of Input and related attributes (such as Hysteresis) for this object instance. 
Data Units and Data Type will match the source attribute's Data Units and Data Type. See 
Appendix C for Data Type definitions and Appendix D for Data Units (ENGUNITS) 
definition. 


Polarity and Output 


The value of the Output attribute is derived by combining the value of the Status attribute with 
that of the Polarity attribute. For a Polarity value of Normal, the Output will equal the value of 
Status. For a Polarity value of Reverse, the Output will equal the value of Status inverted. The 
following relationships demonstrate this logic: 


For (Polarity = 0): Output = Status 
For (Polarity = 1): Output = Status Inverted 


The Polarity attribute is optional and is anticipated to be used only to overcome a hardware 
limitation. 
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5-40.3.5 Source and Input 


The Source attribute defined as data type Packed EPATH (see CIP Common Specification, 
Appendix C), specifies the path for the input whose value is retrieved and becomes the value of 
Input. 

5-40.3.6 Destination and Output 


The Destination attribute, defined as data type Packed EPATH (see CIP Common 
Specification, Appendix C), specifies the path for the output whose value is set with the value 
of Output. 


5-40.4 Common Services 
The Trip Point Object provides the following Common Services: 


Table 5-40.3 Trip Point Object Common Services 


Service Need in Implementation Service Name Description of Service 


OEhex Conditional * | Required Get_Attribute_Single | Returns the contents of the 
specified attribute. 
10hex n/a Set_Attribute_Single | Modifies an attribute value. 


- The Get_Attribute_Single service is REQUIRED if any attributes are implemented. 


See Appendix A for description of these services 
5-40.5  Object—Specific Services 
The Trip Point Object provides no Object-Specific services. 
5-40.6 Behavior 


5-40.6.1 Trip Point Object States 


Figure 5-40.4 Trip Point Object State Transition Diagram 


Power Applied or Reset 


Idle 


Activated | | Deactivated 


Executing 
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Trip Point Object, Class Code: 35yex 


Table 5-40.5 DS Instance Behavior State Description 


State Description 
EXECUTING | The Object instance is performing its normal functions. 


IDLE The Object instance is not performing its normal function. 


The STATUS attribute is NOT ASSERTED 


Internal requests are coordinated such that the EXECUTING state here will align with the 
OPERATIONAL state of the Identity object as well as the EXECUTING state of the S-Device 
Supervisor object in devices where these objects coexist. Transitions to all other states by these 
objects will cause this object to transition to its IDLE state. 


The Activated and Deactivated events correspond to Identity Object events. Where this object 
is used with an S-Device Supervisor object (see Chapter 5-35), these events are similarly 


aligned, but further include alignment with S-Device Supervisor events as specified in Chapter 
5-35. 


Trip Point Object State Event Matrix 


Table 5-40.6 State Event Matrix for S-Device Supervisor Object 


STATE 
Power Applied Default Entry Point = 
Identity Object Transition to EXECUTING State Ignore Event 
Transition to Operation state 
(as by an Activated event) 
Identity Object Ignore Event Transition to IDLE State 
Transition from Operation state 
(as by a Deactivated event) 
S-Device Supervisor Object Transition to EXECUTING State Ignore Event 
Transition to Executing State 
S-Device Supervisor Object Ignore Event Transition to IDLE State 
Transition from Executing State 
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Drive Data Object, Class Code: Not Assigned 


5-41 Drive Data Object 
Class Code: Not Assigned 


"This Section is being Reserved for the Drive Data Object." 
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5-42 


5-42.1 


File Object 
Class Code: 37hex 


The number of instances of this object is dependent on the device, and can be obtained by 
getting the Number_of_Instances class attribute. A device may support creation of new 
instances, and deletion of these dynamically created instances. Instances built into the product 
shall not be able to be deleted. Instances of the File Object are divided into the following 
address ranges to provide for publicly defined and product specific files. 


File Object, Class Code: 374Hex 


Table 5-42.1 File Object Instance ID Ranges 


Range Meaning Quantity 
1— C7 hex Vendor/Product Specific 199 
C8 hex — FF hex Reserved for CIP (Publicly defined) 56 
100 nex — 4F Fhex Vendor/Product Specific 1024 
500nex — FFFFFFFFhex | Reserved for CIP (Publicly defined) 4,294,966,016 


Class Attributes 


Table 5-42.2 File Object Class Attributes 


Attr Need in Access Name Data Description of Semantics of 
ID implementation Rule Type Attribute Values 
1 These class attributes are optional and are described in Chapter 4 of this Specification. 
thru 
2 
3 Required Get Number_of_In | UINT Number of 0 — 65535 
stances instances present 
in this device. 
4 These class attributes are optional and are described in Chapter 4 of this volume. 
thru 
7 
32 Required Get Directory Array of List of all Number of 
Struct instance and file instance names 
names present returned is given in 
within this device | attribute 3, 
and the associated | Number_of_Instan 
instance number. | ces. The Instance 
and File Names are 
instance attributes 
2 and 4, 
respectively. 
Instance UINT 
Number 
Instance_Name | STRINGI 
File_Name STRINGI 
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Instance Attributes 


Table 5-42.3 File Object Instance Attributes 


Attr Need in Access | NV Name Data Description of Semantics of Values 
Ip | Implementation | Rule Type Attribute 
1 | Required Get V_ | State USINT State of the 0 = Nonexistent 
Object 1 = File Empty (no file loaded) 
2 = File Loaded 
3 = Transfer Upload initiated 
4 = Transfer Download initiated 
5 = Transfer Upload in Progress 
6 = Transfer Download in Progress 
7 = Storing 
8 — 255 = Reserved 
2 | Required Get” NV | Instance STRINGI | Name assigned to | See Semantics section 
Name this instance. 
3 | Required Get! NV | Instance UINT Format version of | See Semantics section 
Format the instance. 
Version 
4 | Required Set! NV | File Name | STRINGI | Name assigned to | See Semantics section 
file loaded in this 
instance. 
5 | Required Get! NV | File USINT Major_Revision | See Semantics section 
Revision USINT Minor_Revision 
6 | Required Get! NV | File Size UDINT Size of the See Semantics section 
loaded file. 
7 | Required Get! NV | File INT Checksum of the | See Semantics section 
Checksum loaded file. 
8 | Required Get” NV | Invocation | USINT Method of 0 = No action required 
Method invoking 1 = Reset to Identity Object 
downloaded file. | 2 = Power cycle on device 
3 = Start Service request required 
4 —99 = Reserved by CIP 
100 — 199 = Vendor Specific 
200 — 254 = Reserved by CIP 
255 = Not applicable 
9 | Required Get V | FileSave | BYTE Provides See Semantics section 
Parameters information 
concerning the 
nonvolatile 
storage of the 
file. 
10 | Required Set NV | File Type | USINT Specifies the file ) 0 = Read/Write (default) 
type. 1 = Read Only 
2 — 255 = Reserved 
11 | Optional Get NV | File USINT Defines the See Section 5-42.8. 
Encoding encoding format 
Format of the data in the 
file. 


1. This attribute is updated by way of an object specific service. 
2. This attribute is assigned by the product in ‘factory provided’ instances, or assigned by the user during the creation of a 
new object. 
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5-42.2.1.1 


5-42.2.1.2 


5-42.2.1.3 


5-42.2.1.4 


5-42.2.1.5 


5-42.2.1.6 


5-42.2.1.7 


File Object, Class Code: 37+Hex 


Semantics 


Instance_Name 


This text string describes the meaning of the instance. The name is assigned by either the 
product (product defined instances) or the user (user created instances). An example of an 
Instance Name is “Configuration”. All Instance and File names shall be unique across all 
instances of this class. 


Instance Format Version 


The Instance Format Version value indicates the file format revision of the loaded file. This is 
a vendor/file specific format, except for the public instances. 


File_Name 


This text string provided by the user identifies the file loaded for the instance. A File Name 
example (given an Instance Name = “Configuration”) is “Product mix 4 run”. If a file has not 
been loaded into the instance, the file name shall be NULL. This attribute is updated upon 
successful completion of a file download (based on the value provided in the 
Initiate_Download service) and may be changed by the user after the download. All Instance 
and File names shall be unique across all instances of this class. 


File Revision 


This attribute is assigned by the user to identify different revisions of a file for the given 
instance. If a file is not loaded into the instance, both Major and Minor revision shall be zero. 
This attribute is updated upon successful completion of a file download based on the value 
provided in the Initiate_Download service. 


File_Size 


This value represents the actual size of the file, in bytes, and is updated at the successful 
completion of a download based on the total number of bytes transferred. If the transfer fails 
and the device is not capable of maintaining the previous file (if one existed) the file_size shall 
be set to zero. 


File Checksum 
The checksum value is for the entire file. It is the two’s complement of the sixteen-bit sum of 
all file data. 

File Save Parameters 


This attribute provides information about the nonvolatile save of the file. The bit definition is 
defined below: 


Bit 0: If set, save is required for nonvolatile storage, otherwise it is saved automatically. 
Bits 1-3: Reserved 
Bit 4: Save status; if set loaded file has been saved to nonvolatile storage. 
Bits 5-7: Reserved 
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5-42.3 Common Services 


Table 5-42.4 File Object Common Services 


Service | Need in Implementation Service Name Description of Service 
Code Class Instance 


0x06 N/A Optional Start Used to enable file 

0x07 N/A Optional Stop Used to disable file 

0x08 Optional | N/A Create’ Creates new Upload/Download Object. 

0x09 N/A Optional Delete’ Deletes object previously created using the 
Create service. 

Ox0E Required | Required Get_Attribute_Single | Returns the contents of the specified attribute. 

0x10 N/A Conditional ” Set_Attribute_Single | Writes the contents of the specified attribute. 

0x15 N/A Optional Restore Restores a file from nonvolatile storage. 

0x16 N/A Optional Save Saves a loaded file to nonvolatile storage. 

0x18 N/A Conditional Get_Member 3 Returns a member element of an array attribute 


1 These services shall be supported together. 
* This service is required when the file type is Read/Write. See error codes in table 5-42.18 


> This service shall be supported if Identity attribute 12 is implemented. 


See Appendix A for complete description of these services 


5-42.3.1 Create Service Description 


Creates a new file transfer instance in the device. The Instance_Name parameter is loaded into 
the Instance_Name instance attribute of the newly created object. In addition, the State 
attribute is set to one (Empty, No File Loaded), the File_Name attribute is set to NULL, and the 
Revision attribute is set to zero. If a Create request is received with an Instance_Name, which 
duplicates an existing Instance or File Name, then an error is returned indicating Invalid 
Parameter (Error Code 20,,,). 


Table 5-42.5 Create Request Parameters 


Parameter Name Description of Parameter Semantics of Values 
Instance_Name STRINGI Name applied to this instance. 


Table 5-42.6 Create Response Parameters 


Parameter Name Data Type Description of Parameter Semantics of Values 


Instance_Number UINT Instance number allocated 0-65535 
Invocation _Method | USINT Method of invoking loaded file. See Instance Attribute semantics 
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5-42.4.2 


File Object, Class Code: 37+Hex 


Object-specific Services 


Table 5-42.7 File Object Object-specific Services 


Service Need in Implementation Service Name Description of Service 
Code Class Instance iat 

0x4B N/A Required Initiate_Upload Used to start a file upload 

0x4C N/A Conditional ! Initiate_Download Used to start a file download 

0x4D N/A Optional Initiate_Partial_Read | Used to start a partial read of a file 

Ox4E N/A Optional Intitiate_Parial_Write | Used to start a partial write of a file 

Ox4F N/A Required Upload_Transfer Performs a file transfer upload 

0x50 N/A Conditional ! Download_Transfer Performs a file transfer download 

0x51 N/A Conditional! | Clear File Clears a loaded file 


' These services are required if File Type is Read/Write. Otherwise, they are not supported. 
Initiate_Upload Service Description 


Initiates a file upload. The client indicates the maximum transfer size it can handle. The server 
indicates total file size and actual transfer size. The device updates the State attribute to 
‘Transfer Upload Initiated’ if successful. 


Table 5-42.8 Initiate_Upload Request Parameters 


Parameter Data Type Description of Parameter Semantics of Values 
Name 
Maximum USINT Maximum number of bytes the client can accept in 
Transfer Size each transfer service. 


Table 5-42.9 Initiate_Upload Response Parameters 


Parameter Data Type Description of Parameter Semantics of Values 
Name 


File Size UDINT Size of file to upload, in bytes. This value may be the 
maximum number of bytes, which can be transferred 
from this instance, and not the actual file size. 


Transfer Size USINT Maximum number of bytes the device will deliver in 
the File_Data parameter of each Upload Transfer 
response. This value shall be equal to or less than the 
Maximum Transfer Size specified in the request. The 
server may send less than this amount. 


Initiate_Download Service Description 


Initiates a file download. The client indicates total file size, instance format version, file 
revision, and file name. The server returns the transfer size, number of bytes for each ‘save to 
non-volatile memory’ and the time required to do the save operation. The device updates the 
State attribute to ‘Transfer Download Initiated’. If an Initiate_Download request is received 
with a File Name, which duplicates an existing Instance or File Name, then an error is returned 
indicating Invalid Parameter (Error Code 20,,x). 
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File Object, Class Code: 374Hex 


Table 5-42.10 Initiate_Download Request Parameters 


Parameter Description of Parameter Semantics of 
Name Values 


File Size Size of file to download, in bytes. This value may be the 
maximum number of bytes, which can be transferred from 
this instance, and not the actual file size. 


Instance Version of the Instance format, which this file is based on. 
Format The server shall verify that this file format is supported. 
Version 

File Revision Major Revision 


Minor Revision 


These values are used to update the File Revision instance 
attribute after successful completion of the download. 


File Name STRINGI User assigned name of file to download. This value is 
used to update the File_Name instance attribute after 
successful completion of the download. 


Table 5-42.11 Initiate_Download Response Parameters 


Parameter Data Type Description of Parameter Semantics of 
Name Values 
Incremental UDINT Number of bytes before a save to non-volatile memory 
Burn occurs. The save operation may cause the device to delay 
responding to the transfer which causes a non-volatile save 
to occur. 
Incremental UINT Number of seconds required to perform the save to non- 0 — 65535 seconds 
Burn Time volatile memory. 
Transfer Size | USINT Maximum number of bytes the device will accept the 
File_Data parameter of each Download Transfer request. 
The client may send less than this amount. 


Initiate_Partial_Read Service Description 


Initiates a partial file read. The client indicates the file offset, number of bytes to read, and 

maximum transfer size it can handle. The server shall verify that the entire data range exists in 
the file. The server returns the read size (which shall match the requested read size) and actual 
transfer size. The device updates the State attribute to “Transfer Upload Initiated’ if successful. 


Table 5-42.12 Initiate_Partial_Read Request Parameters 


Parameter Data Type Description of Parameter Semantics of 
Name Values 


File Offset UDINT Byte offset into the file where the read begins. 
Read Size UDINT Number of bytes to read, starting at File Offset. 


Maximum 


USINT Maximum number of bytes the client can accept in each 
Transfer Size transfer service. 


The Initiate_Partial_Read Response Parameters are identical to the Initiate_Upload Response 
parameters. 
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5-42.4.4 Initiate_Partial_Write Service Description 


Initiates a partial file write. The client indicates file offset, write size, instance format version, 
and file revision. The server shall verify that the entire data range exists in the file. The server 
returns the transfer size, number of bytes for each ‘save to non-volatile memory’, and the time 
required to do the save operation. The device updates the State attribute to ‘Transfer Download 
Initiated’. 


Table 5-42.13 Initiate_Partial_Write Request Parameters 


Parameter Data Type Description of Parameter Semantics of 
Name Values 


File Offset UDINT Byte offset into the file where the write begins. 

Write Size UDINT Number of bytes to write, starting at File Offset 
Instance UINT Version of the Instance format, which this file is based 
Format on. The server shall verify that this file format is 
Version supported. 

File Revision | USINT Major Revision 


USINT Minor Revision 


These values are used to update the File Revision 
instance attribute after successful completion of the 
download. 


The Initiate_Partial_Write Response Parameters are identical to the Initiate_Download 
Response parameters. 


5-42.4.5 Upload_Transfer Service Description 


Performs a file upload. The client and server both verify that an 8-bit value (the Transfer 
Number), which is sent by the client and returned by the server, is correct (starts at zero and 
increments by one on each transfer). The State attribute is updated at the first (“Transfer 
Upload in Progress’) and last (‘File Loaded’ or ‘Empty, No File Loaded’) transfers. The last 
transfer packet contains a 16-bit checksum appended to the end of the file data, which is 
matched by the client to what it calculated. The checksum is not included in the file size. 


The server shall send the next packet if the transfer number is one more than the last (or zero 
and this is either the first packet or a rolled over count), resend the last packet if the transfer 
number is the same as the last request, or send an error response (error code 20hex, Invalid 
Parameter and Additional Error Code 06),.x) if the transfer number is neither of the above 
values. 


Table 5-42.14 Upload_Transfer Request Parameters 


Parameter Data Type Description of Parameter Semantics of Values 
Name 


Transfer This 8 bit value starts at zero and is 0-255=Transfer number 
Number incremented on each additional transfer. The 

value ‘rolls over’ to zero after 255. The 

server uses this value to verify the correct 

packet is received. 
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Table 5-42.15 Upload_Transfer Response Parameters 


Parameter Data Type Description of Parameter Semantics of Values 
Name 
Transfer USINT The transfer number is an 8 bit value echoing | 0 — 255 = Transfer number 
Number back the transfer number received. 
Transfer USINT The transfer packet type provides ‘first’, 0 = First transfer packet 
Packet Type ‘middle’, and ‘last’ transfer information, as 1 = Middle transfer packet 
well as the ability to terminate the transfer. _ f k 
The client uses this value to verify integrity 2 = Last transfer packet 
of the transfer, and to determine the 3 = Abort transfer 
completion of the transfer. 4 = First and last packet 
5 — 255 = Reserved 
File_Data Array of File transfer data. 
BYTE 
Transfer INT Checksum of all transferred file data, only on 
Checksum last transfer. 


Download_Transfer Service Description 


Performs a file download. The client and server both verify the Transfer Number is correct 
(starts at zero and increments by one on each transfer). Upon receipt of the first transfer the 


State attribute is updated to “Transfer Download in Progress’. The last transfer packet contains 
a 16 bit checksum appended to the end of the file data which is matched by the client to what it 


calculated. The checksum is not included in the file size. Upon completion, the server shall 
verify the checksum and then update the State attribute (‘File Loaded’ or ‘File Empty’). If the 


operation was successful, the File Name, File Revision, File Size, and File Checksum attributes 


are updated. If not, the object transitions to the File Empty state. 


When this service is received, the server shall either accept the packet if the transfer number is 


one more than the last (or zero and this is either the first packet or a rolled over count), discard 
the packet if the transfer number is the same as the last request, or send an error response (error 
code 20hex, Invalid Parameter and Additional Error Code 06x) if the transfer number is neither 


of the above values. All error conditions and codes for this service are described in the table 
below. This object defines one Object Class specific error code. 


Table 5-42.16 Download_Transfer Request Parameters 


Parameter 
Name 


Transfer 
Number 


Transfer 
Packet Type 


Description of Parameter 


The transfer number is an 8 bit value which 
starts at zero and is incremented on each 
additional transfer. The value ‘rolls over’ to 
zero after 255. The server uses this value to 
verify integrity of the transfer. 


The transfer packet type provides ‘first’, 
‘middle’, and ‘last’ transfer information, as 
well as the ability to terminate the transfer. 
The server uses this value to verify integrity 
of the transfer, and to determine the 
completion of the transfer. 
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0 — 255 = Transfer number 


0 = First transfer packet 

1 = Middle transfer packet 
2 = Last transfer packet 

3 = Abort transfer 

4 = First and last transfer 
5 — 255 = Reserved 
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Parameter Data Type Description of Parameter Semantics of Values 
Name 
File_Data Array of File transfer data. 
USINT 
Transfer 


UINT Checksum of all transferred file data, only on 
Checksum last transfer (Transfer Packet Type = Last). 


Table 5-42.17 Download_Transfer Response Parameters 


Parameter Data Type | Description of Parameter Semantics of Values 
Name 
Transfer USINT Transfer number echoed back to client. The 0-255=Transfer number 
Number client uses this value to verify integrity of the 

transfer. 


5-42.4.7 Clear File 


This object-specific instance service clears (deletes contents of) a loaded file from both volatile 
and nonvolatile memory. There are no parameters defined. In addition to the deletion of the 
file data, the State is set to File Empty and the following attributes of the instance are cleared: 


File Name 

File Revision 

File Size 

File Checksum 

File Save Parameters 


5-42.5 Error Codes 


5-42.5.1 Error codes for Initiate Services 


The following tables define error codes are used by the Initiate_Upload, Initiate_Download, 
Initiate_Partial_Read and Initiate _Partial_Write services. 


Table 5-42.18 Error Codes for all Initiate Services 


Error Condition Error Code Additional Error Code 
OBSOLETE - File Size too large 20hex OOnex 
OBSOLETE - Instance Format Version not Compatible 20hex O1nex 
File Size too large 20hex O4nex 
Instance Format Version not Compatible 20hex O5nex 
Fail on transfer — zero size 20hex O8nex 
File name too long’ 15hex OLnex 
Too many languages in File Name’ 15hex O2nex 


! These errors shall also be used if the condition is detected when the Set_Attribute_Single service is used on 
File Name. 


Table 5-42.19 Error Codes Specific to Initiate Partial Services 


Error Condition Error Code Additional Error Code 
File Offset out of range 20hex O2nex 
Read/Write Size goes beyond end of file 20hex O3Bhex 
File does not exist 02 hex FF hex 
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Error codes for Transfer Services 


The following table defines error codes are used by the Download_Transfer and 
Upload_Transfer services. 


Table 5-42.20 Error Codes for Transfer Services 


Error Condition Additional Error Code 

OBSOLETE - Fail on transfer — out of sequence 00hex 
OBSOLETE - Fail on transfer — other Olhex 
Fail on transfer — out of sequence 06 nex 
Fail on transfer — other 20hex O7 nex 
Fail on transfer — zero size OBnex 
Duplicate File Name 20nex O9nex 
Fail on checksum FF hex 
Fail on save to non-volatile memory 19hex FF hex 

Behavior 

Checksum 


The checksum is a way of checking the file transfer’s accuracy. It is the two’s complement of 
the sixteen-bit sum of all file data transferred. To quickly determine a checksum value, add up 
the file transfer data byte’s hex values. If the total is greater than 10000}-, , drop the most 
significant digit. Then, subtract the result from 10000).x. The checksum value provides only a 
medium level of data security. It cannot detect transposition of bytes during transmission of 
the file. It also cannot detect the insertion or deletion of the value zero within a packet. 
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Figure 5-42.21 State Transition Diagram for File Object 
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5-42.6.2 State Event Matrix 
Table 5-42.22 File Object State Event Matrix 
File Object State 
Non- File Transfer Transfer Storing File Loaded | Transfer Transfer 
Existent Empty Download Download in Upload Upload in 
Event Initiated Progress Initiated Progress 
Power Up If object Not Not applicable Not applicable Not applicable | Not Not Not 
exists then applicable applicable applicable applicable 
If file loaded 
transition to 
File Loaded 
Else 
transition to 
File Empty 
Create If Instance Not Not applicable Not applicable Not applicable | Not Not Not 
Name applicable applicable applicable applicable 
unique 
transition to 
File Empty 
Else Return 
error: 
Invalid 
Parameter 
Initiate Return error: | Process Clear previous Clear all file data | Return error: Clear all file Return error: | Return error: 
Download Object Does anne envite daa and attributes’, Object State data and Object State Object State 
received Not Exist data , process new process new Conflict attributes’ , Conflict Conflict 
transition to | service fais service data PEOCESS 1 
Transfer transition to service data , 
Download Transfer transition to 
Initiated Download Transfer 
Initiated Download 
Initiated 
Download Return error: | Return error: | Process first Return error: Return error: Return error: | Return error: | Return error: 
Transfer, First | Object Does | Object State | block of data, Object State Object State Object State Object State Object State 
Packet 5 Not Exist Conflict transition to Conflict, clear all | Conflict Conflict Conflict Conflict 
Transfer file data and 
Download in attribute 
Progress transition to File 
Empty 
Download Return error: | Return error: | Return error: Process data Return error: Return error: | Return error: | Return error: 
Transfer, Object Does | Object State | Object State Object State Object State Object State Object State 
Middle Not Exist Conflict Conflict, Conflict Conflict Conflict Conflict 
Packet 5 transition to File 
Empty 
Download Not Return error: | Return error: Process data, Return error: Return error: Return error: Return error: 
Transfer, Last | applicable Object State | Object State checksum. If not | Object State Object State Object State Object State 
Packet 5 Conflict Conflict, valid return Conflict Conflict Conflict Conflict 


transition to File 
Empty 


error: Invalid 
Parameter and 
transition to File 
Empty Else 
update attribute 
values and If 
auto-save 
transition to 
Storing Else 
transition to File 
Loaded 
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File Object State 
Non- File Transfer Transfer Storing File Loaded | Transfer Transfer 
Existent Empty Download Download in Upload Upload in 
Event Initiated Progress Initiated Progress 
Nonvolatile Not Ignore Event | Ignore Event Ignore Event Transition to Ignore Event | Ignore Event | Ignore Event 
storage applicable File Loaded 
complete 
Initiate Return error: | Return error: | Return error: Return error: Return error: Process Process new Process new 
Upload Object Does Object State Object State Object State Object State service dita’ service hee pala 
Not Exist Conflict Conflict Conflict Conflict tfansition'ta data, 
Transfer transition to 
Upload Transfer 
Initiated Upload 
Initiated 
Upload Return error: | Return error: | Return error: Return error: Return error: Return error: | Retrieve first | Return error: 
Transfer, First | Object Does | Object State | Object State Object State Object State Object State block of data, | Object State 
Packet Not Exist Conflict Conflict Conflict Conflict Conflict transition to Conflict, 
Transfer transition to 
Upload in File Loaded 
Progress 
Upload Return error: | Return error: | Return error: Return error: Return error: Return error: | Return error: | Retrieve 
Transfer, Object Does | Object State | Object State Object State Object State Object State Object State data 
Middle Packet | Not Exist Conflict Conflict Conflict Conflict Conflict Conflict, 
transition to 
File Loaded 
Upload Return error: | Return error: | Return error: Return error: Return error: Return error: | Return error: | Retrieve 
Transfer, Last | Object Does | Object State | Object State Object State Object State Object State Object State data and 
Packet Not Exist Conflict Conflict Conflict Conflict Conflict Conflict, checksum, 
transition to transition to 
File Loaded File Loaded 
Clear 5 Return error: | Return Clear all file Clear all file Clear all file Clear all file Clear all file Clear all file 
Object Does | success data, Transition | data, Transition | data, Transition | data, data, data, 
Not Exist to File Empty to File Empty to File Empty Transition to | Transition to | Transition to 
File Empty File Empty File Empty 
Transfer Not Not Transition to File | Clear all file data | Not applicable | Not Transition to | Transition to 
Failure/Abort | Applicable applicable Empty and stnibutes. applicable File Loaded File Loaded 
Transfer transition to File 
Empty 
Delete Return error: | Transition to | Clear all file data | Clear all file data | Clear all file Clear all file Clear all file Clear all file 
Object Does | Non- and eid tae and eta data and data and data and data and 
Not Exist Existent Transition to Transition to ahisutes”. Attributes”. atisibutiaa’ sires 
Non-Existent Non-Existent Transition to Transition to | Transitionto | Transition to 
Non-Existent Non-Existent | Non-Existent | Non- 
Existent 
Save Return error: | Return error: | Return error: Return error: Return error: Save file data | Return error: | Return error: 
Object Does | Object State | Object State Object State Object State and attributes | Object State Object State 
Not Exist Conflict Conflict Conflict Conflict to nonvolatile | Conflict Conflict 
storage. 
Restore Return error: | Restore file | Return error: Return error: Return error: Clear all file Return error: | Return error: 
Object Does | data and Object State Object State Object State data and Object State Object State 
Not Exist attributes Conflict Conflict Conflict ateabaieee) Conflict Conflict 
from . Restore new 
nonvolatile file data and 
storage, attributes 
transition to fron 
File Loaded. nonvolatile 
storage. 
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File Object State 

Non- File Transfer Transfer Storing File Loaded | Transfer Transfer 

Existent Empty Download Download in Upload Upload in 

Event Initiated Progress Initiated Progress 
Download Return error: | Return error: | Same as Return error: Same as Return error: Return error: Return error: 
Transfer, Object Does | Object State | Download Invalid Download Object State Object State Object State 

First-and- Not Exist Conflict Transfer First Parameter, Transfer Last Conflict Conflict Conflict 
Last Packet in transition to File | Packet 


last Packet ° ‘ 
the Download in | Empty 


Progress state 


Upload Return Return Return error: Return error: Return error: | Return Same as Return 
Transfer, error: error: Object State Object State Object State | error: Object | Upload error: 
First-and- Object Object Conflict Conflict Conflict State Transfer Object 
last Packet Does Not | State Conflict Last Packet | State 
Exist Conflict in the Conflict, 
Transfer transition 


Upload in to File 
Progress Loaded 
state 


Processing the Initiate Download service data requires temporary storage of the file name, file size, format version, and file revision and an 
initialization of the internal transfer variables (file location, transfer number, etc.). If the file name is not unique among all file/instance names 
associated with the class, then an error is returned indicating Invalid Parameter. 


Clearing the previous Initiate Download service data requires deletion of the parameters stored temporarily from the previous Initiate Download 
service request. 


Clearing all file data and attributes requires the deletion of all file data and settable attribute values (file name, file size, etc.) from volatile memory (or 
from non-volatile memory if data storage is only in non-volatile storage). If the device has only non-volatile storage for this data than the file is lost 
during this process. If the device has separate volatile and non-volatile storage for the file, it may be recovered by a power cycle or the Restore 
service. 


Processing the Initiate Upload service data requires resolution/retention of the maximum transfer size and an initialization of the internal transfer 
variables (file location, transfer number, etc.). 


When any of these service requests are received and the instance type is Read Only, the error response shall be Object Does not exist for the Non- 
existant state. In all other states, the error response shall be “Service not supported” if the File type can be modified by the user or “Object state 
conflict” if the instance is fixed as Read Only. 


5-42.7. Predefined File Instances 


Predefined instances of the File class allow for special purpose files to exist on any product, 
regardless of vendor or device type. Each predefined file defines non-volatile attribute values, 
services supported and any other type of behavior. The following table lists these publicly 
defined files. 


Table 5-42.23 Table of Predefined File Instances 


Instance Number File Description Section 
C8hex This Device’s EDS File and Icon File 5-42.7.1 
Chex Collection of related EDS and Icon files 5-42.7.2 
CAhex — Ffhex Reserved by CIP 
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This Device’s EDS File and Icon File — (C8hex) 


This instance shall contain the EDS file for the device (the device containing this instance), and 
optionally the Icon file for the device. If this is a device that uses Modular EDSs, then this is 
the EDS file and Icon for the adapter. One of the following shall be present in this instance: 


e Uncompressed EDS file for this device (File Encoding Format 0) 


e Compressed EDS file for this device (File Encoding Format 1) 


e Compressed EDS and Icon files for this device (File Encoding Format 1) 


The following tables describe the services supported and attribute values for this instance. 


Table 5-42.24 Table of Required Attributes for File Instance C8,,x 


Attribute ID Access Allowed Attribute Name Attribute Value 

uf Get State See section 5-42.2 

2 Get Instance Name “EDS and Icon Files” 

3 Get Instance Format Version | 1 

4 Get File Name “EDS.gz” if compressed 
“EDS.txt” if not compressed 

5 Get File Revision Shall be the same as the EDS 
Revision field that is within the 
EDS file. 

6 Get File Size See section 5-42.2 

7 Get File Checksum See section 5-42.2 

8 Get Invocation Method 255 

9 Get File Save Parameters 0 

10 Get File Type 1 

11 Get File Encoding Format Oorl 


Table 5-42.25 Table of Service Codes for File Instance C8}, 


Service Code Service Name Need In Implementation 
Ox0E Get_Attribute_Single Required 
0x4B Initiate Upload Required 
0x4D Initiate Partial Read Optional 
Ox4F Upload Transfer Required 
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5-42.7.2 Collection of Related EDS and Icon Files — (C9pex) 


This instance shall contain a collection of 1 or more EDS and Icon files related to this device, 
as well as the Icon file for this device if the EDS file (contained in instance C8}.x) is stored 
uncompressed. This instance could be applied in support of modular systems, although it is not 
restricted to that use. This instance shall not contain any files that are included in instance C8hex 
(defined in 5-42.7.1). 


The following tables describe the services supported and attribute values for this instance. 


Table 5-42.26 Table of Required Attributes for File Instance C9),.x 


Attribute ID Access Allowed Attribute Name Attribute Value 
2 Get Instance Name “Related EDS and Icon Files” 
3 Get Instance Format Version | 1 
4 Get File Name “EDSCollection.gz” 
5 Get File Revision This is a file revision for the 


entire collection and not 
necessarily the revision of any 
file within the collection. 


6 Get File Size See section 5-42.2 
7 Get File Checksum See section 5-42.2 
8 Get Invocation Method 255 

9 Get File Save Parameters 0 

10 Get File Type 1 

11 Get File Encoding Format 1 


Table 5-42.27 Table of Service Codes for File Instance C9), 


Service Code Service Name Need In Implementation 
Ox0E Get_Attribute_Single Required 
0x4B Initiate Upload Required 
0x4D Initiate Partial Read Optional 
Ox4F Upload Transfer Required 


5-42.8 File Encoding Format 


File data may be encoded (for example, by compressing the data). Attribute 11 (File Encoding 
Format) of this object shall define the type of encoding. If this optional attribute is not 
supported there is no encoding on the data or it is unknown. 


5-42.8.1 Table of File Encoding Format Values 


The defined file encoding formats are listed in the following table. 
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Table 5-42.28 Table of File Encoding Format Values 


Attribute Value Meaning 
0 File should be considered as binary — no character, end of line translation or other 
interpretation should be applied. 
1 Compressed file or files. Using the ZLIB compression explained in 5-42.8.2 
2-255 Reserved 


Compressed File — ZLIB Encoding (01 hex) 


The file shall be encoded with the ZLIB compression file format. ZLIB is a free, general 
purpose, legally unencumbered, loss-less compression library. The specifications are available 
from the Internet Engineering Task Force (http://www. ietf.org) as: 


e RFC 1950, May 1996 (ZLIB Compressed Data Format Specification V.33), 
e RFC 1951, May 1996 (DEFLATE Compressed Data Format Specification V. 1.3), 
e RFC 1952, May 1996 (GZIP File Format Specification Version 4.3). 


A compression and decompression utility and source code are available from the ODVA 
website (www.ODVA.org). Additional restrictions on the compressed file(s) are: 


e Names of files shall be at least one character long, and no more than 32 characters long. 
e Characters shall be ASCII characters: 0-9, a-z, A-Z, “.”, “-“, “_” case sensitive. 

e Duplicate file names are not allowed. 

e Directory structure is not supported. 

e File attributes and time/date stamps are not supported. 


— 5-367 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 5 


S-Partial Pressure Object, Class Code: 384ex 


5-43 S-partial Pressure Object 
Class Code: 38x 
An S-Partial Pressure Object provides the means for scanning the partial pressures of a selected 
Atomic Mass Units (AMU) or gas species. Instances of this object are configured for: AMU, 
AMU range, gas species or Total Pressure. Class Level services are provided for: requesting a 
list of configured instances; requesting a list of enabled partial pressures above their respective 
report thresholds; requesting a list of all enabled partial pressures, irrespective of their report 
threshold; and, enabling/disabling a group of instances. Also, instance create, delete services 
are supported. 
This object is a member of the Hierarchy of Semiconductor Equipment Devices. As such, its 
behavior is managed by the S-Device Supervisor Object. See the object definition in Chapter 5. 
The S-Partial Pressure object makes use of a list of Standard Gas Type Numbers. This list is 
described in publication: 
SEMI E52-95 “Practice for Referencing Gases Used in Digital Mass Flow Controllers”, 
Semiconductor Equipment and Materials International (SEMI), Mountain View, CA 94043- 
4080. 
Note: It is implied that the reference above is to the latest revision as specified by SEMI. 
5-43.1 Class Attributes 
Table 5-43.1 S-partial Pressure Object Class Attributes 
Attribute Need in Access | NV Name Data Type Description of Semantics of Values 
ID Implementation | Rule Attribute 
1-7 These class attributes are optional and are described in Chapter 4 of this specification. 
32 Required Set V_ | Filament BYTE Enables a filament | Bit mapped byte 
Control to turn on if not 
interlocked see Semantics section 
33 Required Get V_ |Filament Status | BYTE Indicates that a Bit mapped byte 
filament is on or 
off andifa see Semantics section 
filament fault 
condition exists 
34 Required Get V_ | Reading Invalid | BOOL A device will 0 = Valid 
indicate Reading 1 = Invalid 
Invalid if it 
determines that one 
or more of its 
operational 
parameters are 
beyond factory set 
limits. 
35 Optional Set NV Emission REAL Filament emission | AMPS 
Current current 
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Attribute Need in Access | NV Name Data Type Description of Semantics of Values 
ID Implementation | Rule Attribute 
36 Optional Set Vv Multiplier On |BOOL Turns on the 0 = Off 
electron multiplier | 1=On 
37 Optional Set NV Multiplier REAL Sets the multiplier | VOLTS 
Voltage field excitation 
voltage 
38 Optional Set NV Samples USINT specifies the 0 = manufacturer default 
number of samples | [default] 
configured for each 
enabled instance 
39 Optional Set NV Scan Count | UINT increments by one | 0 - 65535 
upon completion of 
each Measurement | (value after 65535 is 0) 
Scan ** 
97-98 | Reserved by CIP for Future Use 
99 Conditional * Get | NV | Subclass UINT Identifies a subset | 0 = No Subclass 


of additional 
attributes, services 
and behaviors. The 
subclasses for this 
object are specified 
at the end of this 
object specification 
section 


1 — 65535 = Reserved 


* Tf the value of this attribute is 0, then its support is OPTIONAL, otherwise support is REQUIRED 


** A Measurement Scan is considered to be one complete cycle of measurements performed by the Device. 


5-43.1.1 


5-43.1.2 
5-43.1.2.1 


Class Level Subclasses 


Each class level subclass defines a unique meaning for an overlapping range of class attribute 
IDs and/or class service IDs. The range for subclass definitions begins at ID 96 and numbers 
downward for attributes, and ID 63). and numbers downward for services. The subclass for a 
given class is identified by the value of its Subclass class attribute. The subclasses for this 
object are specified at the end of this object specification section. 


Semantics 


Filament Control 


A bit that is set to 1 (one) in the Control byte enables the corresponding filament to turn on. 
Once enables, a filament will turn on if it is able. Various external or internal interlocks may 
prevent the filament from turning on. 


Table 5-43.2 Filament Control Attribute 


ODVA & ControlNet International, Ltd. 


Bit 7 Bit 0 
Reserved | Reserved | Reserved | Reserved | Filament 4 | Filament 3 | Filament 2 | Filament 1 
Enable Enable Enable Enable 
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5-43.1.2.2 Filament Status 
If a filament is on, the corresponding Filament On bit in the Status byte is set to 1 (one). Ifa 
filament has been determined by the device to be in a fault state (such as a burned out or broken 
filament), the corresponding Filament Fault bit on the Status byte is set to 1 (one). 
Table 5-43.3 Filament Status Attribute 
Filament 4 | Filament 3 | Filament 2 | Filament 1 | Filament 4 | Filament 3 | Filament 2 | Filament 1 
Fault Fault Fault Fault On On On On 
5-43.2 Instance Attributes 
Certain minimal implementations may support some optional “Set” attributes as “Get” only and 
still be compliant with this object specification. All required attributes must be supported as 
specified. 
Table 5-43.4 S-partial Pressure Object Instance Attributes 
Attr Need in Access | NV Name Data Type Description of | Semantics of Values 
ID | Implementation | Rule Attribute 
1 Optional Get V_ | Number of USINT Number of The number of 
Attributes supported attributes supported 
attributes by this object instance 
2 Optional Get V_ | Attribute List ARRAY OF |List of supported | The list of attributes 
USINT attributes supported by this 
object instance 
3 Required Set NV | Instance Type USINT Specifies the 0 = AMU [default] 
measurement type | 1 = AMU Range 
for the instance 2 = Gas Species 
3-50 = reserved 
51-99= Device 
Specific 
100-255 = Vendor 
Specific 
4 Conditional * Set NV | AMU REAL Atomic Mass Unit | [default] = 0 
(or Starting AMU 
for analog) see Semantics section 
5 Conditional * Set NV | Ending AMU REAL Ending AMU for | see Semantics section 
an AMU Range 
type instance 
6 Conditional * Set | NV | Gas Standard UINT Gas Species Type | [default] = 0 (no gas 
Number Number type specified) 
see Semantics section 
7 Required Get V_ | Status BYTE Alarm and see Semantics section 
Warning State of 
this object instance 


S-Partial Pressure Object, Class Code: 38 4x 


An attempt to set a Filament Enable bit corresponding to a filament not supported by the device will 
return an Invalid Attribute Value error, as will an attempt to set a filament state not supported by the 
device (e.g., multiple filaments enabled). 
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Attr Need in Access | NV Name Data Type Description of | Semantics of Values 
ID | Implementation | Rule Attribute 
8 Optional Set NV | Alarm High BOOL Enables the setting | 0 = disable [default] 
Enable of the Alarm High | 1 = enable 
Status Bits 
9 Optional Set NV | Alarm Low BOOL Enables the setting | 0 = disable [default] 
Enable of the Alarm Low |1= enable 
Status Bits 
10 Optional Set NV | Warning High | BOOL Enables the setting | 0 = disable [default] 
Enable of the Warning 1 = enable 
High Status Bits 
11 Optional Set NV | Warning Low BOOL Enables the setting | 0 = disable [default] 
Enable of the Warning 1 = enable 
Low Status Bits 
12 Required Set NV | Instance Enable | USINT Enables the 0 = disable [default] 
measurement of 1 = normal scan rate 
this AMU 2 = double scan rate 
3-50 = reserved 
51-99= Device 
Specific 
100-255 = Vendor 
Specific 
see Semantics section 
13 Required Get V_ | Partial Pressure | REAL The measured The measured value 
Partial Pressure of | of partial pressure for 
the specified AMU | this AMU. 
Units are specified by 
attribute Pressure 
Units. 
14 Optional Set NV | Pressure Units |ENGUNITS _ | Determines the see Appendix D fora 
units context of the | list of values. 
Partial Pressure 
attribute [default] = Torr 
If attribute is not 
supported, [default] is 
implied. 
15 Optional Set NV | Dwell Time UINT Determines the Time in Milliseconds 
acquisition time for 
this AMU 0 = fastest possible 
[default] 
16 Optional Set NV | Electron Energy | REAL Indicates the Units = eV 


Electron Impact 
Ionization Voltage 


[default] = Factory 
Configured 
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Attr Need in Access | NV Name Data Type Description of Semantics of Values 
ID | Implementation | Rule Attribute 
17 Optional Set NV | Report REAL Trip point for The level above 
Threshold reporting in the which the Partial 
Get_Pressures Pressure will be 
service response reported. 
see Class Level 
Services 
[default] = 0 
18 Optional Set NV | Alarm Trip REAL Determines the see Semantics section 
Point High Value above which 
an Alarm [default] = Maximum 
Condition will value for its data type. 
occur 
19 Optional Set NV | Alarm Trip REAL Determines the see Semantics section 
Point Low Value below which 
an Alarm [default] = Minimum 
Condition will value for its data type. 
occur 
20 Optional Set NV | Alarm REAL Determines the see Semantics section 
Hysteresis amount by which 
the Value must [default] = 0 
recover to clear an 
Alarm Condition 
21 Optional Set NV | Warning Trip REAL Determines the see Semantics section 
Point High Value above which 
a Warning [default] = Maximum 
Condition will value for its data type. 
occur 
22 Optional Set NV | Warning Trip REAL Determines the see Semantics section 
Point Low Value below which 
a Warning [default] = Minimum 
Condition will value for its data type. 
occur 
23 Optional Set NV | Warning REAL Determines the see Semantics section 
Hysteresis amount by which 
the Value must [default] = 0 
recover to clear a 
Warning Condition 
24 Optional Set NV | Group ID USINT Identifies this 0 - 255 groups 
instance as 
belonging to the 
specified group 
97 - | Reserved by CIP for Future Use 
98 
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Attr Need in Access | NV Name Data Type Description of | Semantics of Values 
ID | Implementation | Rule Attribute 
99 Conditional ** Get NV Subclass UINT Identifies a subset | Q = No Subclass 


of additional 
attributes, services | 1 - 65535 = Reserved 
and behaviors. The 
subclasses for this 
object are specified 
at the end of this 
object specification 
section. 


* Which of these parameterization attributes are supported depends upon the allowable values for the Instance Type 
attribute. 

** Tf the value of Subclass is 00, which identifies "no subclass", then this attribute is OPTIONAL in implementation, 
otherwise, this attribute is REQUIRED. 


5-43.2.1 


5-43.2.2 
5-43.2.2.1 


5-43.2.2.2 


5-43.2.2.3 


Instance Level Subclasses 


Each instance level subclass defines a unique meaning for an overlapping range of instance 
attribute IDs and/or instance service IDs. The range for subclass definitions begins at ID 96 
and numbers downward for attributes, and ID 63;., and numbers downward for services. The 
subclass for a given instance is identified by the value of its Subclass instance attribute. The 
subclasses for this object are specified at the end of this object specification section. 


Semantics 


Instance Type 


The vendor must specify which values are supported. An attempt to set this attribute to an 
unsupported value will return an Invalid Attribute Value error. 


AMU 


The AMU attribute is used to configure the instance for a particular Atomic Mass Unit. For 
basic AMU type configurations, this specifies the point at which the partial pressure is 
determined. For AMU Range type configurations, this specifies the point at which the range of 
AMU begins. A value of zero (0) configures the object instance for Total Pressure. Total 
Pressure is defined as the sum of all enabled S-Partial Pressure object instances. For Gas 
Species type configurations, this value is ignored. 


Ending AMU 


For basic AMU type configurations, this value is ignored. For AMU Range type 
configurations, this specifies the point at which the range of AMU ends. For Gas Species type 
configurations, this value is ignored. 
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5-43.2.2.5 


5-43.2.2.6 


5-43.2.2.7 


5-43.2.2.8 


S-Partial Pressure Object, Class Code: 38 4x 


Gas Standard Number 


The Gas Standard Number attribute is used to configure the instance for a particular gas 
species. For basic AMU, and AMU Range, type configurations, this value is ignored. For Gas 
Species type configurations, this specifies the Gas Standard Number for the particular gas 
whose partial pressure is being measured and reported. 

The actual coding of the values are described in the following publication: 


See introduction section (above) for reference to the SEMI publication: 
“Practice for Referencing Gases Used in Digital Mass Flow Controllers”. 


Status 


Status is a bit mapped byte, which indicates the Alarm and Warning Exception status of the 
object instance. The following definition applies: 


Table 5-43.5 Status Attribute 


Bit Definition 

0 Alarm High Exception: 0 = cleared; 1 = set 

1 Alarm Low Exception: 0 = cleared; 1 = set 

2 Warning High Exception: 0 = cleared; 1 = set 
3 Warning Low Exception: 0 = cleared; 1 = set 
4 Reserved 

5 Reserved 

6 Reserved 

7 Reserved 


Instance Enable 


The Instance Enable attribute is used to turn on/off the object instance. Although an instance 
may be completely configured, if disabled, the device will skip the partial pressure 
measurement in its scan routine. 


Due to the time dependent nature of measuring a partial pressure, a feature is included that 
allows for a double scan rate. This mode of operation causes the device to measure this AMU 
twice as often as it normally would. This yields a faster update rate for this AMU’s partial 
pressure Measurement. 


Dwell Time and Electron Energy 


In the event that one of these values is modified while the device is actively acquiring a 
corresponding reading, the measurement in process shall proceed as originally configured and 
the new values shall take effect on subsequent readings. 


Trip Points and Hysteresis 
A Trip Point High value is that value above which the Value attribute will cause an Alarm or 


Warning exception condition. 


A Trip Point Low value is that value below which the Value attribute will cause an Alarm or 
Warning exception condition. 
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A Hysteresis value specifies the amount by which the Value attribute must transition in order to 
clear an Alarm or Warning condition. For example: A Trip Point High value of 100 anda 
hysteresis value of 2 will result in an exception condition being set when the Partial Pressure 
is above 100 and cleared when the Partial Pressure drops below 98. Similarly, A Trip Point 
Low value of 100 and a hysteresis value of 2 will result in an exception condition being set 
when the Partial Pressure is below 100 and cleared when the Partial Pressure increases above 
102. 


Common Services 


Table 5-43.6 S-partial Pressure Object Common Services 


Service | Need in Implementation Service Name Description of Service 
Code Class Instance 

Olnex n/a Optional Get_Attributes_All Returns a predefined listing of this 
objects attributes (See the 
Get_Attributes_All Response definition 
below) 

O8hex Optional n/a Create Requests an instantiation of a new object 
within this class 

O9hex Optional * Optional Delete Deletes an object instance 

OEhex Conditional | Required Get_Attribute_Single | Returns the contents of the specified 

iad attribute. 
10hex n/a Required Set_Attribute_Single | Modifies an attribute value. 


* The Delete service request at the class level deletes all instances. 
**The Get_Attribute_Single service is REQUIRED if any attributes are implemented. 


See Appendix A for definitions of these common services. 
Get_Attributes_All Response 
At the Class level this service is not supported. 


At the Instance level, the order of the attributes returned in the “Object/Service specific reply 
data” portion of the Get_Attributes_All response is as follows: 


Table 5-43.7 Get_Attributes_All Response Service Data 


Byte Bit 7 Bit 6 Bit5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
0 Number of Attributes Default = 0 
[specifies N bytes] 
1 Attribute List (attribute # 1) 
N Attribute List (attribute # N) 
N+1 thru _| Attributes 3-99 as specified in the above Attribute List 
End 


Important: If the instance attribute “Number of Attributes” is not supported, the default value 
of zero is to be inserted in its place and no members of the ”Attribute List” attribute will 
follow. 


Important: Default values for all unsupported attributes are inserted. 
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5-43.4 Object—specific Services 
Table 5-43.8 S-partial Pressure Object-specific Services 
Service Need in Implementation Service Name Description of Service 
Code Class Instance 
4Bhex Required n/a Create_Range Requests a Create for range of 
instances. 
See description below. 
4Chex Required na Get_Instance_List Requests a list of all enabled 
object instances with their 
respective AMU numbers 
4Dhex Optional n/a Get_Pressures Requests a list of all enabled 
Partial Pressures above their 
respective thresholds 
4Ehex Optional n/a Get_All_Pressures Requests a list of all enabled 
Partial Pressures 
4Fhex Optional n/a Group_Enable Enables or Disables a group of 
instances as identified by their 
respective Group ID attribute 
values 
5-43.4.1 Create_Range Service 
Table 5-43.9 Create_Range Request Service Data Field Parameters 
Parameter Required Data Type Description 
Start AMU Required REAL Specifies the AMU value to be assigned to the first 
instance 
End AMU Required REAL Specifies the AMU value to be assigned to the last 
instance 
Number of Required UINT Specifies the number of instances to be created 
Instances 
Starting ID Required UINT Specifies the first instance ID in the list to be created. 
0 = use next available 
Group ID Optional USINT Specifies the Group value to assign to the created 
instances. 


The successful response to a Create_Range service request is the creation of multiple S-Partial 
Pressure object instances. The device automatically sets the AMU value of each instance such 
that the range of AMU specified in the request is covered in evenly spaced increments by the 
specified number of instances. 


If the Starting ID parameter value is zero (0), the device will start with the first available 
instance ID that allows for the Number of Instances specified to be created in one contiguous 
ID numbered range. 


Table 5-43.10 Create_Range Success Response Service Data Field Parameters 


Parameter Data Type Description 
Starting ID UINT Indicates the first instance ID in the list created 
Ending ID UINT Indicates the last instance ID in the list created 
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5-43.4.2 Get_Instance_List Service 
The Get_Instance_List service request has no service data field parameters. 
Table 5-43.11 Get_Instance_List Success Response Service Data Field Parameters 
Parameter | Required | Data Type Description Semantics of Values 
Size of List Required UINT Specifies the number | Number of object instances in the list 
of elements in the 
Array 
List of Gas Required ARRAY of | Supported List The list of enabled object instances 
Calibrations | if Size>0O | oppyctT 
of 
UINT Instance Number 
USINT Instance Type 
REAL AMU 
REAL Ending AMU 
UINT Gas Standard 
Number 
5-43.4.3. Get_Pressures Service 
The Get_Pressures service request has no service data field parameters. 
Table 5-43.12 Get_Pressures Success Response Service Data Field Parameters 
Parameter | Required | Data Type Description Semantics of Values 
Size of List Required UINT Specifies the number Number of Partial Pressures in the list 
of elements in the 
Array 
List of Gas Required ARRAY of | Supported List The list of all enabled Partial Pressures 
Calibrations | if Size >0 above their respective thresholds 
STRUCT 
of 
UINT Instance ID 
REAL Partial Pressure 
5-43.4.4 Get_All_ Pressures Service 


The Get_All_Pressures service request has no service data field parameters. 


Table 5-43.13 Get_All_Pressures Success Response Service Data Field Parameters 


Parameter | Required | Data Type Description Semantics of Values 
Size of List Required UINT Specifies the number | Number of Partial Pressures in the list 
of elements in the 
Array 
List of Gas Required ARRAY of Supported List The list of all enabled Partial Pressures 
Calibrations | if Size>0 | opRUCT of 
UINT Instance ID 
REAL Partial Pressure 
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5-43.4.5 Group_Enable Service 


Table 5-43.14 Group_Enable Request Service Data Field Parameters 


Parameter Required | Data Type Description 
Enable Required BOOL 0 = Disable 
1 = Enable 
Group ID Required USINT Specifies the Group (i.e., all S-Partial Pressure object 


instances whose Group ID attribute has this value is effected 
by this service request) 


An unrecognized Group parameter returns an Invalid 
Parameter error. 


The Group_Enable Service Reply has no service data field parameters. 


5-43.5 Object Behavior 


The behavior of this object is managed by the S-Device Supervisor Object, defined in Section 
5-35. 
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S-Sensor Calibration Object 


Class Code: 40x 


An S-Sensor Calibration Object affects the behavior of an associated S-Analog Sensor object 
instance; a device profile will show a relationship between these two objects where they are 
used. The S-Analog Sensor object uses the Calibration Object Instance attribute (Attribute ID 
35) as a selection mechanism. The S-Sensor Calibration Object provides the data with which a 
device enacts the appropriate calibration algorithm for a given application. Usually, these 
calibration objects are instantiated in correspondence to various application parameters for a 
particular sensor type, for example fluid type. Each S-Sensor Calibration Object Instance 
contains a set of attribute values for one particular calibration set. 


The S-Sensor Calibration class level object provides a service for retrieving a list of all valid 
object instances. The service response includes a list of elements. Each element includes: 
Instance ID, Calibration ID Number and the valid S-Analog Sensor object instance ID for 
which the instance is valid. 


There may be more than one instance with the same Calibration ID Number. These instances 
may be differentiated by Full Scale, Calibration Name, Additional Scaler and/or other 
parametric distinctions, including valid S-Analog Sensor object instance ID. The distinctions 
may, or may not, be evident in the Get_All_Instances service response, depending upon what 
the distinction is. 


S-Sensor Calibration Objects most often utilize the region of Manufacturer Defined 
Coefficients Attributes (ID 16-31) for specific calibration parameters. If more coefficients are 
needed, then they may be placed into the area of ID >100 — the vendor-specific range. 


This object is a member of the Hierarchy of Semiconductor Equipment Devices. As such, its 
behavior is managed by the Device Supervisor Object. See Section 5-35 of this volume for 
more information. 


Class Attributes 
Table 5-44.1 S-Sensor Calibration Object Class Attributes 


Need in Access Name Data Type 
implementation | Rule 


These class attributes are either optional or conditional and are described in Chapter 5 of this 
specification. 


Attribute 
ID 


Description of Attribute 


1 thru 7 


Reserved by CIP for Future Use 


7 


* Tf the value of Subclass is 00, which identifies "no subclass", then this attribute is 
OPTIONAL in implementation, otherwise, this attribute is REQUIRED. 


Identifies a subset of additional 
class attributes, services and 
behaviors. 
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5-44.2 Subclasses 


Each class level subclass defines a unique meaning for an overlapping range of class attribute 
IDs and/or class service IDs. The range for subclass definitions begins at ID 96 and numbers 
downward for attributes, and ID 63;., and numbers downward for services. The subclass for a 
given class is identified by the value of its Subclass class attribute. The subclasses for this 
object are specified at the end of this object specification section. 


5-44.3 Instance Attributes 


Certain minimal implementations may support any optional “Set” attributes as “Get” only and 
still be compliant with this object specification. All required attributes must be supported as 
specified. 


Table 5-44.2 S-Sensor Calibration Object Instance Attributes 


Attr Need in Access | NV Name Data Type Description of Semantics of 
ID eee Rule Attribute Values 
1 NV_|Number of USINT Number of 
Attributes attributes supported 
2 NV_ |Attribute List ARRAY OF | List of attributes 
USINT supported by this 
object instance 
3 CalibrationID  |UINT Identifies the see Semantics 
Number Calibration (e.g., | section 
fluid type) [default] = 0 
4 Valid Sensor UINT S-Analog Sensor |0= No Valid 
Instance object instance ID |Sensor 
for which this n = Instance ID 
object instance is | ag Semantics 
valid section 
[default] = 0 
5 Calibration SHORT ASCII Text, max |see Semantics 
Name STRING 50 characters, section 
representation of [default] = null 
the calibration (e.g. 
material type) 
6 Full Scale STRUCT of: |Full Scale of the see Semantics 
device using this section 
object instance [default] = 0, 0 
REAL Amount The amount of 
measured 
parameter 
corresponding to 
full scale. 
ENGUNITS | Units The units for the 
above. 
see Data Units 
Appendix K 
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10 


11 


12 


13 


ry 
os 


15 


16-31 


95-96 
97-98 
99 


S-Sensor Calibration Object, Class Code: 404¢ex 


Need in Access | NV Name Data Type Description of Semantics of 
Implementation | Rule Attribute Values 


Optional NV_ | Additional REAL Additional In addition to the 


Correction Factor {correction 
Optional NV _ |Calibration Date |DATE 


algorithm, this 
amount is 
multiplied to the 
reading. 

Default = 1.0 


Date of Calibration |The date this object 
instance was last 
calibrated 


[default] = 0 


ENGUNITS | Determines the see Semantics 
Units context of the |section 
Temperature 

attribute 


Optional NV _ |Temperature 


Data Units 


Optional 


V_ |Temperature REAL Temperature see Semantics 
section 


Pressure Data ENGUNITS |Determines the 
Units 


see Semantics 
Units context of the |section 
Pressure attribute 


V_ |Pressure REAL Pressure see Semantics 
section 
V_ |Coefficient A REAL The "a" term, ina |y=ax’+bx+c 
quadratic 
correction 
V_ |Coefficient B REAL The "b" term, ina |y=ax’+bx+c 
quadratic 
correction 
Optional V_|Coefficient C REAL The "c" term, ina = ax? 
quadratic 
correction 
Optional NV_ | Manufacturer “s ne ne 
Defined 
Coefficients ** 


Defined by Subclasses below 


G 
S 
S 
S 


Optional 


Optional 


Optional 


Optional | 


Z Z Z Z Z Z 
< 


et 
et 
t 
t 
t 
t 
t 
t 
t 
t 


e 
Se 

e 

e 
Se 
Se 
Se 
Se 


Reserved by CIP for Future Use 


Conditional * Get NV_ {Subclass UINT Identifies a subset |0 = No subclass 
of additional 1—65535 = 
instance attributes, | pecerved 
services and 
behaviors. 


* Tf the value of Subclass is 00, then this attribute is OPTIONAL in implementation, otherwise, 
this attribute is REQUIRED. 


** These attributes (16-31) are set aside for manufacturer specified calibration coefficients. 
This is to encourage the limitation and placement of these to facilitate the user's ability to 
download, upload and otherwise verify these values. 
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5-44.5.1 


5-44.5.2 


5-44.5.3 


5-44.5.4 
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Subclasses 


Each instance level subclass defines a unique meaning for an overlapping range of instance 
attribute IDs and/or instance service IDs. The range for subclass definitions begins at ID 96 
and numbers downward for attributes, and ID 63),., and numbers downward for services. The 
subclass for a given instance is identified by the value of its Subclass instance attribute. The 
subclasses for this object are specified at the end of this object specification section. 


Semantics 


Calibration ID Number 


Used to identify a particular calibration using a standardized identifying number, for which the 
object instance is currently calibrated. See Instance Application Example below. 


The actual coding of these values are specified in the Device Profile or vendor specific 
implementation where used. Since the actual attributes, and their context, for the 
parameterization of object instances for particular calibration types is beyond the scope of this 
standard (i.e., vendor specific) the Access Rule for this attribute has been specified as Get. 
Vendors may choose to specify an Access Rule of Set for this attribute. 


Valid Sensor Instances 


This attribute specifies the S-Analog Sensor object instance for which the S-Sensor Calibration 
object instance is valid. An S-Sensor Calibration object instance will be valid for zero or one S- 
Analog Sensor object instances. 


Calibration Name 


This optional attribute is a string coded representation of the name of the calibration for which 
the object instance has been configured. It is coded as a user defined text symbol or it is coded 
as defined in the Device Profile where used. 


Full Scale 


This optional attribute identifies the amount of measured parameter (e.g., Flow Rate) 
corresponding to the Full Scale of the associated S-Analog Sensor object. A primary purpose 
for this attribute is to allow for simple S-Analog Sensor object implementations where the 
Value is reported in raw units; this attribute allows a mapping to engineering units. 


For example, the Full Scale for a S-Sensor Calibration object may be 100 LPM, while the Full 
Scale for the associated S-Analog Sensor object may be 20,000 counts (i.e., S-Analog Sensor 
object Data Type = INT and Data Units = Counts). 
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5-44.6 


5-44.7 
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Temperature and Pressure 


These optional attributes are used for Calibrations where a temperature and/or a pressure 
dependency is known. These attributes may be supported with "set access" to allow the user 
the configure the calibration object or to continuously feed the value from the network. 
Alternatively, these attributes may be supported with "get access" to identify the temperature 
and/or pressure for which the calibration has been set. Another alternative is that these 
attributes may be shown with a linkage in a Device Profile whereby the value is modified 
internal to the device and would again be shown with "get access" to the network. In the latter 
case, the related Data Units attributes may not be supported. 


Instance Application Example 


The following is an example to demonstrate the usage of S-Sensor Calibration object instances 
and their attributes: 


A device has been supplied with three S-Sensor Calibration object instances: DI Water, 
Ethylene Glycol 50%, and Ethylene Glycol 70%. The user wishes to use the device for 
ethylene glycol 80% and knows that a correction factor of 1.05 will properly convert the 
ethylene glycol 70% calibration for this application. The object instance for ethylene glycol 
70% would be selected and the Additional Scaler attribute for this instance would be set to 
1.05. To identify this modification, the Calibration Name may be set to read “Ethylene Glycol 
80%”, “HOCH2CH20H”, or perhaps, “Coolant X”. 


Common Services 


The S-Sensor Calibration Object provides the following Common Services: 


Table 5-44.3 S-Sensor Calibration Object Common Services 


Service Need in Implementation 
Code Service Name Description of Service 


Returns the contents of 


OEhex Conditional* | Required | Get_Attribute_Single 
the specified attribute. 


Modifies an attribute 


10hex Set_Attribute_Single ; 
value. 


* Required if any attributes are supported. 


** Required if any settable attributes are supported. 


See Appendix A for definition of these services 
Object-specific Services 


Table 5-44.4 S-Sensor Calibration Object-specific Services 


Service Need in Implementation 
Code Service Name Description of Service 


4Bhex Required Get_All_Instances Requests a list of all 
available object 
instances with their 
respective Calibration 
ID Numbers 
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5-44.7.1 Get_All_Instances Request Service Data Field Parameters 


None. 


5-44.7.2. Get_All_Instances Success Response 


Table 5-44.5 S-Get_All_Instances Success Response Service Data Field Parameters 


Parameter Data Type Semantics of Values 


Size of List Required UINT Specifies the number | Number of calibrations in the list 
of elements in the 
Array 
List of Required if ARRAY of Supported List The list of Sensor Calibrations 
Calibrations Size > 0 


Ps STRUCT of | Supported Calibration 
UINT S-Sensor Calibration 
Object Instance ID 
UINT Calibration ID 
Number 
r= 3 UINT Valid Sensor Instance 


5-44.8 S-Sensor Calibration Object Behavior 


The behavior of this object is managed by the S-Device Supervisor Object, defined in Section 
5-35.5. 
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Event Log Object 
Class Code: 41x 


The Event Log Object provides event indication and/or event logging on CIP nodes. Some 
applications may only require event indication, while others may only require event logging. 


Event information is stored in arrays and these arrays have an assumed index equal to the 
element number in the array. 


Multiple object instances are only required for devices which support independent logs. Each 
Event Log Object instance has an event instance identifier (user-defined number and optional 
name). 


Each Event Log Object instance maintains a unique event log, which may contain time- 
stamped application data for that set of events. Each event associated with an instance may be 
assigned a unique identifier. An attribute of the Event Log Object Instance defines all of the 
events associated with the particular instance. Another attribute indicates the current state of 
each event. An event log entry occurs upon a state change in the status of any single event in 
the set of events being monitored by the particular Event Log Object Instance. Data stored 
within the event log is configurable to include application-specific data and time / date, in 
addition to the event identifier. The application data is optionally sent along with the event 
trigger from the application object to the Event Log Object. Both the event log size and its 
storage trigger mechanism are configurable. 


The Event Log Object class maintains a list of the Event Log Object Instances. 
The cause of an event is not defined for the Event Log Object. A local application is the event 


source, and the cause is application-specific. The application object sends the event trigger 
(typically Event Active indication) to the Event Log Object. 


Event Control 

Events can be enabled and disabled as needed. When an event is disabled, all event triggers are 
ignored, meaning no log entries or occur. Events can also be silenced. A silenced event 
continues to log event information. 


Important: Instances of the Event Log Object are divided into the following ranges. 


Table 5-45.1 Event Log Instance ID Ranges 


Range Quantity 
01 - 63hex Public 99 
64hex - C7hex Vendor Specific 100 
C8hex - FFhex Reserved by CIP for future use 56 
100hex - 2FFhex Public 512 
300hex - 4FFhex Vendor Specific 512 
500hex - FFFFpex | Reserved by CIP for future use 64,256 
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5-45.2 Class Attributes 


Table 5-45.2 Event Log Object Class Attributes 


Attribute Need in Access | NV Name Data Type Description of Semantics of 
ne Implementation} Rule Attribute Values 


1 thru 2 |These class attributes are optional and are described in Chapter 4 of this specification. 


3 Conditional * Get NV_|Number of UINT Number of object |The number of object 
Instances instances currently |instances at this class 
created at this class |hierarchy level. 

level of the device 


4 thru 7 |These class attributes are optional and are described in Chapter 4 of this specification. 


32 Conditional Set NV _ |Time Format USINT Data type code for 
time and/or date OxCD = DATE! 
OxCE = TOD' 


OxCF = DATE AND 
TIME! 


OxD6 = FTIME” 
0xD7 = LTIME” 
0xD8 = ITIME” 
0xDB = TIME” (Default) 


33 Conditional Set NV |Present Time Dependant on Default time value = zero 
Attribute #32 for all data types 
34 Optional Get NV Instance List ARRAY of List of all Instance 


STRUCT of numbers and names 


Instance number UINT Number of Event 
Log Object instance 


Instance name STRINGI Length and name of 


Event Log Object 
instance 


' These data types result in a zero value on power-up/reset unless special hardware exists 
* The signed time data types shall not “roll over” into negative values; these values shall “roll over” to zero 


° This attribute is required when attribute #34 is implemented. 


5-45.2.1 Time Format 


Defines the time format used for logging events. All Event Log Object instances shall use the 
same time format. 


If time stamping is implemented, this attribute is required. If time stamping is not supported, 
this attribute shall not be implemented. 


The time formats TIME OF DAY, DATE and DATE AND TIME, if implemented, require the 
device to continue advancing time across power cycling/reset actions. 
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Not all time formats are required to be supported. The time format “TIME” is required. If the 
implementation only supports the default time format “TIME”, this attribute is not required to 


be settable. 


5-45.2.2. Present Time 


This attribute exposes a real time counter whose unit of measure is determined by the Time 
Format attribute. If time stamping is enabled in the Data Log, the value in this attribute is the 
source of the time stamp information. 


If time stamping is supported, this attribute is required. If time stamping is not supported, this 
attribute shall not be implemented. 


If the Set service is implemented for this attribute, the entire range of values, for the time 
format in effect, shall be supported for the Set service. 


Attribute value roll over behavior: For any of the time formats that allow a negative value, the 
Present Time attribute shall not roll over into negative values. 


5-45.2.3 Instance List 


The number(s) and name(s) of all instances contained in the Event Log Class. 


5-45.3 Instance Attributes 


Table 5-45.3 Event Log Instance Attributes 


Attr Need in Access Name Data Type | Description of Attribute Semantics of Values 
ID Implem Rule 


Required G wv State USINT State of this instance. 0 = Nonexistent 
1 = Stopped 
2 = Empty 
3 = Available 
4 = Full/Overwrite 
5 = Full/Halted 
6 — 255 = Reserved 


Set ° 
et 
3 |Conditional!|Get V |Event List Size UDINT Number of elements in the |See semantics 
Event List, Event Enable, 
Event Silenced and Event 
State attribute arrays. 
4  |Optional Set V |Event List ARRAY of {All event identifiers Event Identifier format is 
STRUCT defined for this instance. _|defined by attribute 24. 
Set 
et 


NV 
NV 
Vv 

N 
N 
NV 


5 {Optional Event Enable ARRAY of {Enables each event 0 = Disabled 
BOOL 1 = Enabled 
Default = Enabled 
6 Event Silenced ARRAY of {Inhibits selected Event 0 = Not silenced 
BOOL from continuing to signal | 1 = silenced 
it’s presence in the Event 
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Need in 


Implem 


Get Vv ARRAY of 


BYTE 


Optional Event State 


Z 
< 


Z Z Zz 


Optional Set Logged States BYTE 


Configuration 


Optional Set 


Logged Data 
Configuration 


Optional Set Log Full Action 


Optional Set Duplicate Event 


Action 


Get 


Z 
< 


Required Event/Data Log 


Maximum Size 


Required Get Event/Data Log 


Size 


ARRAY of 
STRUCT 


Required Set Event/Data Log 


Get Active Event/Data |}|UDINT 


List Size! 


Optional 


Optional Get Active Event/Data |ARRAY of 
List STRUCT 
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Description of Attribute Semantics of Values 
Rule 


Log as an active event, 
regardless of it’s present 
condition (Active/Inactive, 
Logged/Not Logged) 


Default = Not silenced 


Identifies the current state 
of each event 


Bit 0 (See attribute #5) 


0 = Disabled 
1 = Enabled 


Bit 1 

0 = Inactive 
1 = Active 
Bit 2 

0 = UnAcked 
1 = Acked 
Bit 3 
0 = Not Logged 

1 = Logged 

Bit 4 (See attribute #6) 


0 = Not Silenced 
1 = Silenced 


Bits 5 7 


(reserved) 
Default = 0x0B 


See Semantics below. 
Default = 0x01 


Configures which event 
state transitions are logged 


See Semantics below. 
Default = 0 


Configures which data is 
stored in the event log. 


0 = Halt (Default) 
1 = Scroll 
2 — 255 = Reserved 


Configures the actionto —_|0 = Ignore (Default) 
take when a duplicate event|1 = Add 

is detected. 2 = Overwrite 

3 — 255 = Reserved 


Configures the action to 
take when a new event is 
detected and the log is full. 


Maximum number of 
allowable entries in 
Event/Data Log. 


The present number of 
entries in the Event/Data 
Log. 


0 to Event Log Maximum 
Size 


List of all events that have |See semantics 
been logged 


Number of entries in 0 to Event List Size 


Active Event List 


List of event identifiers that})See semantics 
are presently active 
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19 |Optional 


21  |Optional 


23  |Optional 
24 |Optional ae 


e 
20 |Optional 
22  |Optional 
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Need in Access | NV Name Data Type | Description of Attribute Semantics of Values 
ID Implem Rule 
Optional Vv 


18 |Optional 


Logged Event/Data |UDINT Number of entries in 0 to Event Log Maximum 
List Size’ Logged Event List Size 


Logged Event/Data |ARRAY of __|List of event identifiers that]See semantics 
List STRUCT are currently logged 
Log Full BOOL TRUE if Event Log Size = |0= Log not full 
Event Log Maximum Size |1 = Log full 
Log Contains Indicates if there are any |0 = Log empty 
Entries events in the log. 1 = Log contains entries 


G 
G 


Indicates if there has been |0 = No Log Overrun 
an overrun of the log. 1 = Log Overrun 


G Log Overrun 


Sequential i Provides a simple See Semantics 
Event/Data Access mechanism to access 
Event/Data entry 


Z 
< 


t 
t 
t 
t 
t 
ti Startup Behavior Specifies the behavior of |0= Auto Active (Default) 
the instance after Power-up }1= Start Required 

or Reset 2-255 = Reserved 

t Event Identifier Defines the format of the |See Semantics 

Format Event Identifier for the log |pefayit = 0 

entries. 


Z 
< 


' This attribute indicates the size of a ‘list’ provided by another attribute and is required if that ‘list’ attribute is present. 


* The logged data is optionally nonvolatile. 


be dynamic instances are possible (via the Create service) and this attribute is implemented, the SetAttributeSingle service is 


5-45.4 


5-45.4.1 


5-45.4.2 


5-45.4.3 


5-45.4.4 


required. 
Semantics: 


Attribute #1 - Instance Name 


Further defines the instance by permitting a string name for the event instance. 


Attribute #2 - State 


See State Transition Diagram (STD) and State Event Matrix (SEM) in section <??? determined 
at spec integration> below. 


Attribute #3 - Event List Size 


The number of members in the Event List, Event Enabled, Event Silenced and Event State 
attributes. 


Attribute #4 - Event List 


The list of unique event identifiers recorded by this object instance. This may not include all 
events which could be logged. 
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5-45.4.5 


5-45.4.6 


5-45.4.7 


5-45.4.8 


5-45.4.9 


Event Log Object, Class Code: 41pex 


Attribute #5 - Event Enable 


Enables or disables the event completely with regard to the Event Log Object. Default is 
enabled 


Attribute #6 - Event Silenced 


Disables the updating of the selected Event regardless of the state of the event, which allows 
the user to stop transmission of individual event indication messages. 


Attribute #7 - Event State 


Current event state for each of the events. Refer to Object Behavior section. 


Attribute #8 - Logged States Configuration 


Defines when an event log entry is recorded, based on event state changes. Allows the user to 
select which state changes require an event log entry, optimizing event log memory usage. 
More than one state change can be enabled simultaneously. Selecting no state changes disables 
event logging without disabling the state monitoring capability of the object. 


Table 5-45.4 Defined Values For the Logged States Configuration Attribute 


Value Description 
Bit 0 Log state transitions to Active or Inactive 
Bit 1 Log state transitions to Disabled or Enabled 
Bit 2 Log state change due to UserAck 
Bits 3 - 7 Reserved 


Attribute #9 - Logged Data Configuration 


Defines the information to be stored in the Event/Data Log (Attribute 14). The logged data 
shall always begin with the Event Identifier (format defined in Attribute 24), and may be 
followed by optional data blocks as they appear in the table below, from low bit (Bit 0) to high 
bit (Bit 7). If a bit is set, the corresponding data block appears in the Event/Data Log. 


Table 5-45.5 Defined Values For the Logged Data Configuration Attribute 


Value Description 
Bit 0 Time value (data value defined by Time Format class attribute) 
Bit 1 New event state (data value defined by Event State attribute) 
Bit 2 Application data’ 


Bits 3 - 7 Reserved 
' The Application data shall be in the form of a Data Segment (see Appendix C) 
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5-45.4.11 


5-45.4.12 


5-45.4.13 


5-45.4.14 
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Attribute #10 - Log Full Action 


Defines the action to take when a new event is detected and the event log is full. Options 
include scroll and halt. The scroll selection causes new event log entries to overwrite the oldest 
entries when the event log is full. The halt selection causes all new event log entries to be lost 
when the event log is full. 


Table 5-45.6 Defined Values For the Log Full Action Attribute 


Value Description 
0 Halt (stop when log is full) 
1 Scroll (oldest entry is deleted, member list is shuffled down, and 
newest entry is last in the list) 
2-255 Reserved 


Attribute #11 - Duplicate Event Action 


Defines the action to take when a duplicate event is detected. Options include ignore, add, and 
overwrite. The ignore option causes event entries of the same Event Identifier to be discarded. 
The overwrite option causes event entries of the same event to overwrite the previous entry of 
that event. The add to log option allows the same event to be placed in the log each time it 
occurs. 


Table 5-45.7 Defined Values For the Duplicate Event Action Attribute 


Value Description 
0 Ignore 
1 Add 
2 Overwrite 
3-255 Reserved 


Attribute #12 - Event/Data Log Maximum Size 


The maximum number of allowable event/data log entries for the instance. This number may 
vary based on available memory and how the user has configured the event log options. 


Attribute #13 - Event/Data Log Size 


The current number of non-zero entries in an instance’s event/data log. 


Attribute #14 - Event/Data Log 


This attribute is the event/data log for the instance. New events are added to the end of the log, 
subject to overriding behavior specified by the Log Full Action and Duplicate Event Action 
attributes. 
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5-45.4.14.1 


5-45.4.14.1. 


Event Log Object, Class Code: 41pex 


Information contained in the event/data log depends upon its configuration. An entry whose 
value is all zero is defined to be a null entry containing no useful data. This attribute is a single 
dimension array of entries. The maximum size of the array is given by attribute #12 
(Event/Data Log Maximum Size). The present number of entries is given by attribute #13 
(Event/Data Log Size). The form of each entry is determined by the combination of the Event 
Identifier Format (attribute #24) in conjunction with optional data selected by the Logged Data 
Configuration (attribute #9). The table below shows the structure of a logged event entry. 


Table 5-45.8 Structure of Event Entry 


Field Name Need in Where enabled Where Format Defined 
Entry 
Event Required Always Present Event Identifier Format (Instance Attribute 
Identifier 24) 
Time Stamp | Optional Logged Data Configuration Time Format (Class Attribute 32) 
(Instance Attribute 9), Bit 0 
Event State Optional Logged Data Configuration Event State (Instance Attribute 7) 
(Instance Attribute 9), Bit 1 


Application Encoded Data Segment as defined in 

Data (Instance Attribute 9), Bit 2 Appendix C 

For example, assuming the Log Entry Form attribute is the value zero, then the first four octets 
of each member entry shall conform to the 32-bit object model/error response format (the Event 
Identifier). If any optional data is selected by the Logged Data Configuration attribute, the 
selected data will be present in the logged event entry following the Event Identifier. The order 
of the selected fields is defined by the Logged Data Configuration attribute and shown in the 
table above. Continuing this example, assuming the value 0x03 exists in the Logged Data 
Configuration attribute and class attribute #32 (Time Format) is the value OxDB (TIME data 
type), the following table shows the form of each Event/Data Log member entry: 


Table 5-45.9 Event/Data Log Member Entry Form 


Byte Offset Contains 
Event Identifier 8-bit Class Code 
8-Bit Instance 
8-Bit Error/Event Code 
8-Bit Extended Event/Error Code 


Time Value Time Stamp for entry (Low Order Byte) 
Time Stamp (next byte) 
Time Stamp (next byte) 
Time Stamp (High Order Byte) 


New Event State Event State 


Service Behavior: 


OPN] om] ay BR] wy] NynytrrRito 


1 Get_Attribute_Single 


Returns the entire content of the attribute. Each member of the Event Log is returned, 
regardless of whether the content of the member is non-null (valid). Therefore, this service 
always returns “Event Log Maximum Size” times each entry’s “form size” bytes. 
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Table 5-45.10 Get_Attribute_Single Service Error Code 


0x15 Too Much Data The present size of the message necessary to transmit 
all Event Log members exceeds the messaging 
capacity of the node 


5-45.4.14.1.2 Set_Attribute_Single 


The Set_Attribute_Single service shall not be implemented 


Table 5-45.11 Set_Attribute_Single Service Error Code 


0x08 Service Not Supported The Set service is not supported for this attribute 


5-45.4.14.1.3 Get_Member 


Returns the content of the specified member within the Event/Data Log 


Table 5-45.12 Get_Member Service Error Codes 


0x28 Invalid Member ID Member number zero was selected 


0x08 Service Not Supported This implementation of the Event Log object does not 
support the Get Member service 


5-45.4.14.1.4 Set_Member 
Table 5-45.13 Set_Member Service Error Codes 


Error Code Error Name Description 


0x28 Invalid Member ID The specified member does not presently exist 

0x15 Too Much Data The service data of the request contained too much 
data for the form of the Event Log 

0x13 Not Enough Data The service data of the request did not contain enough 
data for the form of the Event Log 

0x0C Object State Conflict The state of the instance is any of: 

Stopped 


Halted 


or the specified member is valid and can not be 
overwritten 


0x09 Invalid Attribute Value The value of the data within the request was rejected 
by the Event Log 

0x08 Service Not Supported This implementation of the Event Log object does not 
support the Set Member service 
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5-45.4.14.1.5 Remove_Member 


Returns the content of the specified member within the Event/Data Log and then the member is 
removed from the Log. 


Table 5-45.14 Remove_Member Service Error Codes 


0x28 Invalid Member ID The specified member does not exist 


0x08 Service Not Supported This implementation of the Event Log object does not 
support the Remove Member service 


5-45.4.14.1.6 Insert_Member 


5-45.4.15 


5-45.4.16 


5-45.4.17 


5-45.4.18 


Inserts the content of the service data into the Event/Data Log at the specified member position. 


Table 5-45.15 Insert_Member Service Error Codes 


Error Code Error Name Description 


0x28 Invalid Member ID The specified member does not exist 

0x15 Too Much Data The service data of the request contained too much 
data for the form of the Event Log 

0x13 Not Enough Data The service data of the request did not contain enough 
data for the form of the Event Log 

0x0C Object State Conflict The state of the instance is any of: 

Stopped 


Halted 


or the specified member is valid and can not be 
moved in the member list 


0x09 Invalid Attribute Value The value of the data within the request was rejected 
by the Event Log 

0x08 Service Not Supported This implementation of the Event Log object does not 
support the Insert Member service 


Attribute #15 - Active Event List Size 


The current number of entries in the Active Event List. 


Attribute #16 - Active Event List 
A list of all currently active events related to the instance from which the list is obtained. 


Attribute #17 - Logged Event List Size 


The current number of entries in the Logged Event List. This list shall be the same size as the 
Event List. 


Attribute #18 - Logged Event List 


A list of all currently logged events related to the instance from which the list is obtained. 
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5-45.4.21 
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Attribute #19 - Log Full 


A flag which indicates if the Event Log is full. TRUE if Event Log Size = Event Log 
Maximum Size, and intended primarily for dynamic log management. 


Attribute #20 - Log Not Empty 


A flag which indicates that the Event Log is not empty (ie. at least one entry is present). This 
value is TRUE when the Event Log Size is not equal to zero. 


Attribute #21 - Log Overrun 


A flag which indicates that an overrun has occurred. This value is reset to zero (FALSE) when 
the attribute is read. 


Attribute #22 — Sequential Event/Data Access 


The Sequential Event/Data Access attribute provides the means for simple sequential access to 
members of the Event/Data Log. The form of the data in this attribute is identical to the form of 
the data contained within individual member(s) of the Event/Data Log (attribute #14). The 
behavior of services to the Sequential Event/Data Access attribute is as follows: 


Table 5-45.16 Sequential Event/Data Access Behavior 


Sequential Event/Data Access | Results in Service to Event/Data 
(attribute #22) Log (attribute #14) 


Service Service Name Service Service Name Behavior 
Code Code 


Ox0E Get_Attribute_ 0x1B Remove_Member The Get_Attribute_Single service, when 
Single directed to the Sequential Event/Data Access 

attribute, causes a Remove_Member service to 
be directed to the Event/Data Log attribute of 
the Event Log object instance. The internally 
generated Remove_Member service will 
always attempt to remove member one of the 
Event/Data Log attribute. 
If the Event/Data log is empty, this service 
shall return no data. 
If the Sequential Event/Data Access attribute 
is implemented, support for the 
Remove_Member service is required. 

0x10 Set_Attribute_ Ox1A Insert_Member The Set_Attribute_Single service, when 

Single directed to the Sequential Event/Data 

Attribute , causes an Insert_Member service to 
be directed to the Event/Data Log attribute of 
the Event Log object instance. The internally 
generated Insert_Member service will always 
attempt to insert the last member of the 
Event/Data Log attribute. 
If the Set_Attribute_Single service is 
implemented for this attribute support for the 
Insert_Member service is required. 
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5-45.4.23 Attribute #23 - Startup Behavior 


Defines the behavior of the instance state machine at startup and reset. 


Table 5-45.17 Startup Behavior Attribute Values 


Value Description 
0 Auto Active 
1 Start Required 
2-255 Reserved 


5-45.4.24 Attribute #24 - Event Identifier Format 
Defines the format of the Event Identifier. 


Table 5-45.18 Values for Attribute #24 


Value Description 
0 32-bit object model/error format 
1 48-bit object model/error format 
2 64-bit object model/error format 
3 16-bit unique identifier value 
4-254 Reserved 


255 Product specific — fixed form 


Table 5-45.19 32-Bit Object Model / Error Format 


Description 


Description 
16-bit object class identification 
8-bit object instance identification 
8-bit Error/Event code 
16-bit Extended Error Code 
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Table 5-45.21 64-Bit Object Model / Error Format 


Description 


5-45.5 Common Services 


Table 5-45.23 Common Services for the Event Log Object 


Service Need In Implementation Service Name ServiceDescription 

O5nex N/A Required Reset Provides one of the types of reset for the 
object as described below. 

O6nex N/A Conditional! | Start Transitions the object from the Configuring 
state to the Active state, which allows event 
logging to commence. 

O7 hex N/A Conditional! | Stop Transitions the object from the Active state to 
the Configuring state. This service causes the 
event list and status attributes to be cleared 
and allows for the setting of some attributes 
which are get-only in the Active state. 

OEnhex Get_Attribute_Single | Returns the contents of the specified attribute. 

10nex Set_Attribute_Single | Sets the contents of the specified attribute. 

18nex Optional Optional Get_Member Returns the contents of a member of the 
specified attribute. 

19hex Modifies a member of the specified attribute. 

1Ahex Adds a member to one of the list attributes. 

1Bhex N/A Optional Remove_Member Removes a member from one of the list 
attributes. 


1 The Delete, Start and Stop services are required if the Create Service is supported. 


2 The Get_Attribute_Single service is required if any attributes are implemented. 


5-45.5.1 Reset Service 


The Reset service has the following object specific parameter: 


Table 5-45.24 Reset Service Object Specific Parameters 


Name Description of Parameter Semantics of Values 
Reset Type USINT Type of reset requested. See table below. 
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The parameter Reset Type for the Reset service has the following value specification: 


Table 5-45.25 Reset Type Value Descriptions 


Value Description of Value 
0 Emulate as closely as possible cycling power, returning all attributes to the power up 
values. This is the default if the parameter is omitted. 
1 Return as closely as possible to the out-of-box configuration, then emulate cycling 
power as closely as possible. 
2-255 Reserved. 


5-45.6 Event/Data Log Instance Behavior 


Figure 5-45.26 Event/Data Log Instance State Transition Diagram 


Non-Existent (0) 


Reset 
Start Required) 


Reset 
(Auto Active) 


Insert 
Member 


Insert Member 
(Full) 


FullOveryrite (4) 


Insert Member 
(Full) 


Change Log Full Action 


Full/Halted (5) 
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Table 5-45.27 Event/Data Log Object State Event Matrix 


Event/Data Log Object Instance State Event Matrix 


Event Non-Existent (0) Stopped (1) Empty (2) Available (3) Full Full 
Overwrite (4) Halted (5) 
Power Up If set to “Power up Not Applicable Not Applicable Not Applicable Not Applicable Not Applicable 
active” transition to 
Empty 
Else transition to 
Stopped. 
Create Transition to Not Applicable Not Applicable Not Applicable Not Applicable Not Applicable 
Stopped 
Delete Not Applicable Delete all resources Return Error Return Error Return Error Return Error 
and transition to (Object State (Object State (Object State (Object State 
Non-Existent. Conflict) Conflict) Conflict) Conflict) 
Start (Not Not Applicable Return Error (Service | Return Error Return Error Return Error Return Error 
supported) not supported) (Service not (Service not (Service not (Service not 
supported) supported) supported) supported) 
Start Not Applicable Transition to Return Error (Object Already in State/Mode) 
(Supported) Available 
Stop (Not Not Applicable Return Error (Service } Return Error Return Error Return Error Return Error 
supported) not supported) (Service not (Service not (Service not (Service not 
supported) supported) supported) supported) 
Stop Not Applicable Return Error (Object Clear the Event Log, Active Event List, Logged Event List. Set Log Full, Log 
(Supported) Already in Not Empty, and Log Overrun attributes to zero. Transition to Stopped. 
State/Mode) 
Reset Not Applicable Perform Reset as Perform Reset as defined by service. 
(Type = 0 or 1) defined by service. 
Get Attribute Not Applicable Validate/service the request. Return response. 
Set Attribute Not Applicable Validate/service the request. Return response. 


SetAttribute Not Applicable Validate/service the request. Return response. 


to “Log Full 
Action” 
attribute 


Insert Member 
(internal) 


Not Applicable 


Ignore 


If attribute 
value after 
service is one 
(Scroll) — 
Transition to 
Full Scroll 


If attribute value 
after service is 
zero (Halt) — 
Transition to Full 
Halted 


If event Not Enabled discard 


Else process event based on Logged Data, Log Full Action, 
and Duplicate Event Action attributes. Update Log Full, 
Log Not Empty, and Log Overrun attributes accordingly. 


Ignore 


Transition to 
Available state 


If Log is now full 
and Log Full 
Action is “Halt” 
— Transition to 
“Full Halted” 


If Log is now full 
and Log Full 
Action is 
“Scroll” — 
Transition to 
“Full Scroll” 
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Event/Data Log Object Instance State Event Matrix 


Event Non-Existent (0) Stopped (1) Empty (2) Available (3) Full Full 
Overwrite (4) Halted (5) 


Insert Member | Not Applicable Return error (Object If event Not Enabled discard Return error 
(via explicit State Conflict) Else process event based on Logged Data, Log Full Action, | (Object State 
service or the and Duplicate Event Action attributes. Update Log Full, Conflict) 
Sequential Log Not Empty, and Log Overrun attributes accordingly. 
Event/Data 
Access 
attribute) 
Transition to If Log is now full 
Available state and Log Full 
Action is “Halt” 
— Transition to 
“Full Halted” 
If Log is now full 
and Log Full 
Action is 
“Scroll” — 
Transition to 
“Full Scroll” 
Remove Not Applicable Return error (Object Return error Remove member at specified index. Update Log Full and 
Member State Conflict) (Object State Log Not Empty attributes accordingly. 
Conflict) 
If last entry Transition to Transition to 
removed, Available Available 
Transition to 
Empty 
Get Member | Not Applicable | | Not Applicable | Validate/service the request. Return response. 


5-45.6.1 Event Behavior 


The Event Log object defines optional states and state transitions for events. This behavior 
definition does not define what physically causes the transition triggers. For example, 
UserACK/Silence could be a pushbutton on one device, and may require an HMI interactive 
sequence on another. The behavior of an event is illustrated in the State Transition Diagram 
and State Event Matrix below. 
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Figure 5-45.28 Event State Transition Diagram 
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Table 5-45.29 State Event Matrix for Events 


Ignore 


Service the request 
and return the 
appropriate 
response. 


Service the request 
and return the 
appropriate 
response. 


Transition to Disabled 


If not silenced, Event 
State = Active 


Log event (if enabled) 


If silenced, transition 
to Active-Acked 


If not silenced, 
transition to Active 


If not silenced, Event 
State = Active-Acked 


Log event (if enabled) 


Transition to Active- 
Acked 


Ignore 


return the appropriate 
response. 


Service the request and 


return the appropriate 
response. 


State 


If not Silenced, Event 
State = Inactive-Acked 


Transition to Disabled 


Event State = Active- 
Acked 


If not silenced, Event 
State = Active 


Log event (if enabled) 


If not silenced, 
transition to Active 


Ignore 


If not silenced, Event 
State = Inactive-Acked 


Transition to Inactive- 
Acked 


Service the request and 


Service the request and 
return the appropriate 
response. 


Return Object State 
Conflict error (OC hex) 


25 AND = 


Edition 3.3 


Transition to Disabled 


Event State = Inactive- 
Acked 


Transition to Inactive- 
Acked 


Not applicable 


If not silenced, Event 
State = Active 


Log event (if enabled) 


If silenced, transition to 
Active-Acked 


If not silenced, 
transition to Active 


Not applicable 


If not silenced, Event 
State = Inactive-Acked 


Transition to Inactive- 
Acked 


Service the request and 
return the appropriate 
response. 


Service the re- quest and 
return the appropriate 
response. 


Transition to Inactive- 
Acked 


ODVA & ControlNet International, Ltd. 


Active 


If not Silenced, Event 
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Transition to Disabled 
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If not silenced, Event 
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Motion Axis Object 
Class Code: 42hex 
Introduction 


This object defines the behavior of a CIP object called the Motion Axis Object. This object is 
the main functional component of CIP Motion device profiles defined as part of the CIP 
Motion extensions to CIP, e.g., the CIP Motion Drive Device Profile. Instances of this object 
are required to support motion control using devices compliant with the CIP Motion Device 
Profile(s) (“CIP Motion Device(s)”) over a CIP Network. The object may be adapted to any 
CIP network. It is generally contemplated that EtherNet/IP would be the network designer’s 
technology of choice for high performance, synchronized multi-axis control. 


9 66 


In this object definition, we use these terms interchangeably: “device”, “motion device” & 
“drive”. 


Organization 


The Motion Axis Object covers the behavior of various motion control system devices that 
includes feedback devices and drive devices. For drive devices, the Motion Axis Object covers 
a wide range of drive types from simple variable frequency (V/Hz) drives, to servo drives. 
Many drive products can be configured to operate in different modes depending on the specific 
application requirement. The attributes of the Motion Axis Object are therefore organized to 
address this broad range of functionality and the framework for this organization is described in 
the following section. 


Control Modes 


This object is organized around the general philosophy that position control is the highest order 
of dynamic motion control. That is, position control implies velocity control, and velocity 
control implies acceleration control. Acceleration is related to torque or force by the inertia or 
mass of the load, respectively, acceleration control implies torque control. And finally, since 
motor torque or force is generally related to motor current by a torque or force constant, 
respectively, torque control implies current control. The torque or force constant can be a 
function of the motor magnets as in a Permanent Magnet motor, or the induced flux of an 
Induction motor. 


Since acceleration, torque/force, and current are generally related by a constant, these terms are 
sometimes used interchangeably in the industry. For example, a torque control loop rather than 
a current control loop. This object attempts to differentiate between these control properties 
were applicable. This is particularly useful when the relationship between them is not static, 
such as when inertia/mass changes with position or time, or when the torque/force constant 
changes due to temperature change or motor flux variation. 


Control Methods 


Within this basic control paradigm, there is latitude for different control methods, both closed 
loop and open loop. By closed loop, it is generally implied that there is a feedback signal that is 
used to drive the actual dynamics of the motor to match the commanded dynamics by servo 
action. In most cases there is a literal feedback device to provide this signal, and in some cases 
the signal is derived from the motor excitation (i.e. sensorless operation). By open loop, it is 
implied that there is no application of feedback to force the actual dynamics to match the 
commanded dynamics. 
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Control Nomenclature 


Typically rotary applications speak of Torque and Inertia while linear applications speak of 
Force and Mass. For the purposes of this document, when we refer to rotary nomenclature, the 
defined behavior can generally be applied to linear applications by substituting the terms, force 
for torque and mass for inertia. With that understanding, we use torque rather than force in the 
diagrams below without loss of generality. 


Position Control 


In position control application mode either the application control program (command 
execution function) or the motion planner (move trajectory control function) provide a set-point 
value to a CIP Motion Device via the cyclic data connection. The position control method can 
be either open loop or closed loop. 


Open Loop Position Control 


A device configured for open loop position control applies to a class of drive devices called 
stepper drives. This type of drive is illustrated below. 


Figure 5-46.1 Open Loop Position Control 


Application Program 


Controller 
Motion Planner 
Command Position Actual Position 
Position Control CIP Motion Device 


Motor + Feedback (opt) Actuator 


A feedback device for this configuration is optional. In the absence of a feedback device, actual 
position can be estimated by the drive and returned to the controller. 


Closed Loop Position Control 


A motion control device configured for closed loop position control is typically referred to as 
position loop drive or position servo drive. A position servo drive implies an inner velocity and 
torque control loop as shown below. The presence of the torque/current control loop sometimes 
results in this kind of drive being referred to as a vector drive. 
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Figure 5-46.2 Closed Loop Position Control 


Application Program 


Controller 
Motion Planner 
Command Position Actual Position 
Position Control 
Velocity Control CIP Motion Device 


Torque/Current Control 


Motor + Feedback Actuator 


A feedback device for this configuration is generally required to achieve good positioning 
accuracy. The feedback device may also be used to return Actual Velocity and Actual 
Acceleration data to the controller via the cyclic data connection. 


In addition to Command Position, the controller can pass Command Velocity and Command 
Acceleration for the purposes of forward control. 


Velocity Control 


In velocity control application mode the application control program and motion planner 
provide a set-point value to a CIP Motion Device via the cyclic data connection. The velocity 
control method can be either open loop or closed loop. 


Open Loop Velocity Control 


A motion control device configured for open loop velocity control is typically referred to as 
Variable Frequency, or V/Hz, or VFD, drive. This type of drive is illustrated below. 


A feedback device for this configuration is optional. In the absence of a feedback device, actual 
velocity can be estimated by the drive and returned to the controller. 
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Figure 5-46.3 Open Loop Velocity Control 


Application Program 


Controller 


Command Velocity Actual Velocity 


Velocity Control CIP Motion Device 


Motor + Feedback (opt) Actuator 


5-46.2.5.2 Closed Loop Velocity Control 


A motion control device configured for closed loop velocity control is typically referred to as 
velocity loop drive or velocity servo drive. A closed loop velocity control drive implies an 
inner torque/current control loop and therefore is sometimes referred to as a vector drive. 


Figure 5-46.4 Closed Loop Velocity Control 
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A feedback device for the velocity loop drive configuration is optional. Tighter speed 
regulation may be achieved when using a feedback device, particularly at low speed. When the 
feedback device is included it may be used to return actual position, velocity, and acceleration 
data to the controller via the cyclic data connection. When the feedback device is not included, 
only estimated velocity can typically be returned to the controller. 


In addition to Command Velocity, the controller can also pass Command Acceleration for the 
purposes of forward control. 


Acceleration Control 


While not a mainstream control mode in the industry, acceleration control mode is included 
here to complete the dynamic progression from velocity control to torque control and because 
the Motion Axis Object can support an Acceleration Command, potentially derived from the 
controller’s motion planner. In the acceleration control mode, the application control program 
and motion planner provide acceleration set-point values to a CIP Motion Device via the cyclic 
data connection. The drive converts the acceleration set-point into a torque command using the 
estimated system inertia. Acceleration control works in concert with the inner torque/current 
control loop as shown below. 


Figure 5-46.5 Acceleration Control 
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A feedback device for the acceleration control configuration is mandatory and may be used to 
return actual position, velocity, and acceleration data to the controller via the cyclic data 
connection. 


Torque Control 


In torque control application mode, the application control program or the motion planner 
provide torque set-point values to the device via the cyclic data connection. Because motor 
current and motor torque are generally related by a torque constant, Kt, torque control is often 
synonymous with current control. 
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Figure 5-46.6 Torque Control 
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A position feedback device for this control mode is optional. If a feedback device is present it 
may be used to return actual position, velocity, and acceleration data to the controller via the 
cyclic data connection. 


5-46.2.8 No Control 


The Motion Axis Object supports a “No Control” application mode. This configuration also 
referred to as “feedback only” or “master feedback”, can be of value when a particular 
feedback channel in the CIP Motion Device is to serve simply as a master feedback source to 
the rest of the control system. This application mode can also be applied to CIP Motion 
Feedback devices. In this “No Control” configuration, no set-point value is supplied to the CIP 
Motion Device via the cyclic data connection, but actual position, velocity, and acceleration 
can be supplied by the device to the controller via the cyclic data channel. The No Control 
drive configuration is illustrated in the diagram below. 


— 5-408 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 6 


5-46.3 


5-46.4 


Motion Axis Object, Class Code: 42hex 
Figure 5-46.7 No Control 
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Drive Control Categories 


Based on the above variations in Control Mode and Control Method we can derive some basic 
Device Control Codes around which we can organize the many attributes of the Motion Axis 
Object. Device Control Codes can be designated using a single letter identifier that can be used 
to determine what object attributes are required for implementation of a given CIP Motion 
Device. The list of Device Control Codes is as follows: 


Control Modes: 

P — Position Control 

V - Velocity Control 

T — Torque Control 

N — No Control (Feedback Only) 


Control Methods: 
F — Frequency Controlled Drives (Open Loop V/Hz or VFD) 
C — Closed Loop Vector Controlled Drives 


Using combinations of these letters we can designate a specific class of CIP Motion devices for 
the purposes of identifying applicable attributes. For example, F would indicate a variable 
frequency drive axis, “V” would refer to velocity controlled drive axis, either open loop or 
closed loop, and “N” would refer to an axis with feedback only functionality. 


Required vs. Optional in Implementation 


In the sections that follow, attributes and services are defined as Required or Optional in the 
implementation of the Motion Axis Object. Required attributes and services must be supported 
in the implementation of the object. Optional attributes and services may or may not be 
supported in the implementation and are left to the discretion of the vendor. 
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The determination of whether a given attribute or service is Required or Optional often depends 
on the associated Device Control Code as defined above. If an attribute or service is marked as 
Required for a given Device Control Code then a device implementation must support that 
attribute or service if it is intended to operate in that mode. For example an attribute marked as 
required for Device Control Code “V” must be supported by any CIP Motion Device that 
supports Velocity control mode. 


In some cases an attribute or service may not even be applicable to a Device Control Code. 
This situation is implied when the attribute is defined as neither Required nor Optional. 


The following table provides a convenient list of all the Instance Attributes of this object and 
identifies whether the attribute is Required or Optional in the implementation based on the 
above Device Control Code. 


Note: If there are any discrepancies between this table and the actual attribute descriptions, the 
attribute descriptions prevail. 


Note: The definition of the abbreviations used in the Conditional Implementation column of the 
following table can be found in section 5-46.10. 


Table 5-46.1 Instance Attribute Implementation vs. Drive Control Category Code 


Instance Attribute Implementation by Drive Category Code 


Attr. ID Access Attribute Name F C - PI Vector Ctrl Conditional 
Rule mil Vv Implementation 
80 Set* Control Mode - R R R R 
81 Set Control Method - R R R R 
1310 Get Motor Catalog Number - O O O O 
1311 Get Motor Serial Number - O O O O 
1312 Get Motor Date Code - O O O O 
1313 Set Motor Data Source - R R R R 
1314 Set Motor Device Code - R R R R 
1315 Set Motor Type - R R R R 
1316 Set Motor Unit - O O O O 
1317 Set Motor Polarity - R R R R 
1318 Set Motor Rated Voltage - R R R R 
1319 Set Motor Rated Continuous Current - R R R R 
1320 Set Motor Rated Peak Current - C Cc Cc C R-—PM; 0O-IM 
1321 Set Motor Rated Output Power - Cc C C Cc R-—PM; O-IM 
1322 Set Motor Overload Limit - O O O O 
1323 Set Motor Integral Thermal Switch - O O O O 
1324 Set Motor Max Winding Temperature - O O O O 
1325 Set Motor Winding-to-Ambient Thermal - O O O O 
Capacitance 
1326 Set Motor Winding-to-Ambient Thermal - O O O O 
Resistance 
1327 Set PM Motor Resistance - R R R R PM Motor only 
1328 Set PM Motor Inductance - R R R R PM Motor only 
1329 Set Rotary Motor Poles - R R R R Rotary Motor only 
1330 Set Rotary Motor Inertia - O O O O Rotary Motor only 
1331 Set Rotary Motor Rated Speed - R R R R Rotary Motor only 
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Attr. ID 


Access 


Rule 


Attribute Name 


C - PI Vector Ctrl 


Conditional 


Implementation 


1332 Set Rotary Motor Max Speed - O O O O Rotary Motor only 
1333 Set Rotary Motor Damping Coefficient - O O O O Rotary Motor only 
1334 Set Linear Motor Pole Pitch - R R R R Linear Motor only 
1335 Set Linear Motor Rated Speed - R R R R Linear Motor only 
1336 Set Linear Motor Moving Mass - O O O O Linear Motor only 
1337 Set Linear Motor Max Speed - O O O O Linear Motor only 
1338 Set Linear Motor Damping Coefficient - O O O O Linear Motor only 
1339 Set PM Motor Rated Torque - R R R R Rotary PM Motor only 
1340 Set PM Motor Torque Constant - R R R R Rotary PM Motor only 
1341 Set PM Motor Rotary Voltage Constant - R R R R Rotary PM Motor only 
1342 Set PM Motor Rated Force - R R R R Linear PM Motor only 
1343 Set PM Motor Force Constant - R R R R Linear PM Motor only 
1344 Set PM Motor Linear Voltage Constant - R R R R Linear PM Motor only 
1345 Set Induction Motor Rated Frequency - R R R R Induction Motor only 
1346 Set Induction Motor Flux Current - R R R R Induction Motor only 
1347 Set Induction Motor Stator Resistance - R R R R Induction Motor only 
1348 Set Induction Motor Stator Leakage X - R R R R Induction Motor only 
1349 Set Induction Motor Magnetization X - R R R R Induction Motor only 
1350 Set Induction Motor Rotor Resistance - R R R R Induction Motor only 
1351 Set Induction Motor Rotor Leakage X - R R R R Induction Motor only 
1400 +0 Get Feedback n Catalog Number - O O O O 
1401 +0 Get Feedback n Serial Number - O O O O 
1402 +0 Get Feedback n Position R - R R O 
1403 +0 Get Feedback n Velocity R - R R O 
1404 +0 Get Feedback n Acceleration R - R R O 
90 Set* Feedback Data Set R R R R R 
82 Set* Feedback Configuration R R R R R 
83 Set* Feedback Master Select R - R R R 
84 Set Feedback 1/2 Count Ratio - - O - - 
1411 +0 Set Feedback n Unit O - O O O 
1412 +0 Set Feedback n Port Select O - O O O 
1413 +0 Set Feedback n Type R - R R R 
1414+0 Set Feedback n Polarity O - O O O 
1415+0 Set Feedback n Mode R - R R R 
1416+0 Set Feedback n Cycle Resolution R - R R R TT, SC, HI, E21, RS 
1417+0 Set Feedback n Cycle Interpolation R - R R R TT, SC, HI, E21, RS 
1420+0 Set Feedback n Data Length R - R R R TP, SS, HI, E21, E22 
1421+0 Set Feedback n Data Code O - O O O TP, SS 
1422 +0 Set Feedback n Resolver Transformer O - O O O RS 
Ratio 
1423 +0 Set Feedback n Resolver Excitation O - O O O RS 
Voltage 
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C - PI Vector Ctrl 


Attr. ID Access Attribute Name Conditional 


Rule 


Implementation 


1424+0 Set Feedback n Resolver Excitation O - O O O RS 
Frequency 
1425+0 Set Feedback n Resolver Cable Balance O - O O O RS 
1426 +0 Set Feedback n LDT Type R - R R R LT 
1427+0 Set Feedback n LDT Recirculations R - R R R LT 
1428 +0 Set Feedback n Commutation Offset R - R R R HS, TP, HI, E21, E22, 
SS, RS (PM Only) 

1434 +0 Set Feedback n Velocity Filter BW. O - O O O 
1435 +0 Set Feedback n Acceleration Filter BW O - O O O 

256 Set* Event Checking Control O - O - - 

257 Get Event Checking Status O - O - - 

258 Get Registration 1 Positive Edge Position R - R - - 

259 Get Registration 1 Negative Edge Position R - R - - 

260 Get Registration 2 Positive Edge Position O - O - - 

261 Get Registration 2 Negative Edge Position O - O - - 

262 Get Registration 1 Positive Edge Time O - O - - 

263 Get Registration 1 Negative Edge Time R - R - - 

264 Get Registration 2 Positive Edge Time R - R - - 

265 Get Registration 2 Negative Edge Time O - O - - 

266 Get Home Event Position R - R - - 

268 Get Home Event Time O - O - - 

93 Get Command Target Time - - O - - 

286 Set* Controller Position Command - - R - - 

287 Set* Controller Velocity Command - - O R - 

288 Set* Controller Acceleration Command - - O O O 

289 Set* Controller Torque Command - - O O O 

290 Get Interpolated Command Position - - O - - 

291 Get Interpolated Command Velocity - - O O - 

292 Get Interpolated Command Accel. - - O O O 

91 Set* Command Data Set - - R R R 

92 Set* Interpolation Control - - R R - 

302 Set Velocity Limit - Positive - - O R - 

303 Set Velocity Limit - Negative - - O R - 

304 Set Acceleration Limit - - O R - 

305 Set Deceleration Limit - - O R - 

306 Set Jerk Limit Control - - O O - 

307 Set Flying Start Enable - - O O - 

308 Set Skip Speed 1 - O - - - 

309 Set Skip Speed 2 - O - - - 

310 Set Skip Speed 3 - O - - - 

311 Set Skip Speed Band - O - - - 

420 Get Position Command - - R - - 
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Rule 


Implementation 


421 Set* Position Trim - - R - - 
422 Get Position Reference - - R - - 
423 Get Velocity Feedforward Command - - R - - 
424 Get Position Feedback R - R R O 
426 Get Position Error - - R - - 
427 Get Position Integrator Output - - R - - 
428 Get Position Loop Output - - R - - 
430 Set Kvff - - R - - 
431 Set Kpp - - R - - 
432 Set Kpi - - R - - 
433 Set Position Lock Tolerance - - R - - 
434 Set Position Error Tolerance - - R - - 
435 Set Position Error Tolerance Time - - O - - 
439 Set Position Integrator Control - - R - - 
440 Set Position Integrator Preload - - R - - 
450 Get Velocity Command - R R R - 
451 Set* Velocity Trim - R R R - 
452 Get Accel. Feedforward Command - - R R - 
453 Get Velocity Reference - R R R - 
454 Get Velocity Feedback R - R R O 
455 Get Velocity Error - - R R - 
456 Get Velocity Integrator Output - - R R - 
457 Get Velocity Loop Output - - R R - 
460 Set Kaff - - R - - 
461 Set Kvp - - R R - 
462 Set Kvi - - R R - 
464 Set Kdr - R O R - 
465 Set Velocity Error Tolerance - - O O - 
466 Set Velocity Error Tolerance Time - - O O - 
467 Set Velocity Integrator Control - - R R - 
468 Set Velocity Integrator Preload - - R R - 
469 Set Velocity Low Pass Filter Bandwidth - - O O - 
470 Set Velocity Threshold - O R R - 
471 Set Velocity Lock Tolerance - O R R - 
472 Set Velocity Standstill Window - R R R - 
480 Get Acceleration Command - - O O O 
481 Set* Acceleration Trim - - O O O 
482 Get Acceleration Reference - - O O O 
483 Get Acceleration Feedback R - R R O 
490 Get Torque Command - - R R R 
491 Set* Torque Trim - - R R R 
492 Get Torque Reference - - R R R 
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Rule 


Attribute Name 


C - PI Vector Ctrl 


Conditional 


Implementation 


493 Get Filtered Torque Reference - R R R 
494 Get Limited Torque Reference - R R R 
496 Set Kj - R R O 
498 Set Friction Compensation - O O O 
502 Set Torque LP Filter Bandwidth - O O O 
503 Set Torque Cmd Notch Frequency - O O O 
504 Set Torque Limit - Positive - R R R 
505 Set Torque Limit - Negative - R R R 
506 Set Torque Rate Limit - O O O 
507 Set Torque Threshold - O O O 
508 Set Overtorque Limit - O O O 
509 Set Overtorque Limit Time - O O O 
510 Set Undertorque Limit - O O O 
511 Set Undertorque Limit Time - O O O 
520 Get Iq Current Command - R R R 
521 Get Operative Current Limit - O O O 
522 Get Current Limit Source - O O O 
523 Get Motor Electrical Angle - R R R 
524 Get Iq Current Reference - O O O 
525 Get Id Current Reference - O O O 
527 Get Iq Current Error - O O O 
528 Get Id Current Error - O O O 
529 Get Iq Current Feedback - O O O 
530 Get Id Current Feedback - O O O 
531 Get Iq Decoupling - O O O 
532 Get Id Decoupling - O O O 
533 Get Vq Voltage Output - O O O 
534 Get Vd Voltage Output - O O O 
535 Get U Voltage Output - O O O 
536 Get V Voltage Output - O O O 
537 Get W Voltage Output - O O O 
538 Get U Current Feedback - O O O 
539 Get V Current Feedback - O O O 
540 Get W Current Feedback - O O O 
541 Get U Current Offset - O O O 
542 Get V Current Offset - O O O 
543 Get W Current Offset - O O O 
554 Get Kqp - O O O 
555 Get Kqi - O O O 
556 Get Kdp - O O O 
557 Get Kdi - O O O 
558 Set Flux Up Control - O O O Induction Motor only 
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Rule 
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559 Set Flux Up Time - - O O O Induction Motor only 
570 Get Slip Compensation - R - - - 
575 Set Frequency Control Method - R - - - 
571 Set Rated Slip Speed - R - - - 
572 Set Maximum Voltage - R - - - 
573 Set Maximum Frequency - R - - - 
574 Set Frequency Limit - R - - - 
575 Set Break Voltage - R - - - 
576 Set Break Frequency - R - - - 
577 Set Start Boost - R - - - 
578 Set Run Boost - R - - - 
600 Get Output Frequency - R - - - 
601 Get Output Current - R R R R 
602 Get Output Voltage - R R R R 
603 Get Output Power - R R R R 
604 Set PWM Frequency - O O O O 
610 Set Stopping Mode - R R R R 
611 Set Stopping Current - - R R R 
612 Set Stopping Time Limit - - R R R 
613 Set Resistive Brake Contact Delay - O O O O PM Motors Only 
614 Set Mechanical Brake Control - O O O O 
615 Set Mechanical Brake Release Delay - R R R R 
616 Set Mechanical Brake Engage Delay - R R R R 
620 Get DC Bus Voltage - R R R R 
621 Get DC Bus Voltage - Nominal - R R R R 
624 Set Bus Regulator Action - R R R R 
625 Set Bus Regulator Power Limit - O O O O 
627 Set Power Loss Action - O O O O 
628 Set Power Loss Threshold - O O O O 
629 Set Shutdown Action - O O O O 
635 Get Motor Capacity - R R R R 
636 Get Inverter Capacity - R R R R 
637 Get Converter Capacity - O O O O 
638 Get Bus Regulator Capacity - O O O O 
639 Get Ambient Temperature - O O O O 
640 Get Inverter Heatsink Temperature - O O O O 
641 Get Inverter Temperature - O O O O 
642 Get Motor Temperature - O O O O 
643 Get Feedback 1 Temperature - O O O O 
644 Get Feedback 2 Temperature - O O O O 
645 Get Inverter Overload Limit - O O O O 
646 Set Motor Overload Action - O O O O 
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647 Set Inverter Overload Action - O O O O 
650 Get Axis State R R R R R 
651 Get Axis Status R R R R R 
652 Get Axis Status - Mfg R R R R R 
653 Get Axis I/O Status R R R R R 
654 Get Axis I/O Status - Mfg R R R R R 
94 Set* Status Data Set R R R R R 
655 Get Axis Exception Status R R R R R 
656 Get Axis Exception Status - Mfg R R R R R 
657 Get Axis Fault Status R R R R R 
658 Get Axis Fault Status - Mfg R R R R R 
659 Get Axis Alarm Status R R R R R 
660 Get Axis Alarm Status - Mfg R R R R R 
661 Get Axis Fault Code R R R R R 
662 Get Axis Fault Code - Mfg R R R R R 
663 Get Axis Fault Time Stamp R R R R R 
664 Get Axis Alarm Code R R R R R 
665 Get Axis Alarm Code - Mfg R R R R R 
666 Get Fault Sub Code O O O O O 
680 Get Motor Overtemperature Factory Limit - O O O O 
681 Get Motor Thermal Overload Factory - O O O O 
Limit 
682 Get Inverter Overtempature Factory Limit - 
683 Get Inverter Thermal Overload Factory - O O O O 
Limit 
684 Get Converter Overtemperature Factory - O O O O 
Limit 
685 Get Converter Thermal Overload Factory - O O O O 
Limit 
686 Get Bus Regulator Overtemperature - O O O O 
Factory Limit 
687 Get Bus Regulator Temperature Overload - O O O O 
Factory Limit 
688 Get Bus Overvoltage Factory Limit - O O O O 
689 Get Bus Undervoltage Factory Limit - O O O O 
695 Set Motor Overspeed User Limit - O O O O 
696 Set Motor Overtemperature User Limit - O O O O 
697 Set Motor Temperature Overload User - O O O O 
Limit 
698 Set Inverter Overtemperature User Limit - O O O O 
699 Set Inverter Temperature Overload User - O O O O 
Limit 
700 Set Converter Overtemperature User - O O O O 
Limit 
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701 Set Converter Thermal Overload User - O O O O 
Limit 
702 Set Bus Regulator Overtemperature User - O O O O 
Limit 
703 Set Bus Regulator Temperature Overload - O O O O 
User Limit 
704 Get Bus Overvoltage User Limit - O O O O 
705 Get Bus Undervoltage User Limit - O O O O 
667 Set Exception Action R R R R R 
668 Set Exception Action - Mfg R R R R R 
669 Get Initialization Fault Status R R R R R 
670 Get Initialization Fault Status - Mfg R R R R R 
671 Get Initialization Fault Code R R R R R 
672 Get Initialization Fault Code - Mfg R R R R R 
673 Get Start Inhibit Status - R R R R 
674 Get Start Inhibit Status - Mfg - R R R R 
675 Get Start Inhibit Code - R R R R 
676 Get Mfg Start Inhibit Code - R R R R 
710 Get Control Power-up Time - O O O O 
711 Get Cumulative Run Time - O O O O 
712 Get Cumulative Energy Usage - O O O O 
713 Get Cumulative Motor Revs - O O O O 
714 Get Cumulative Main Power Cycles - O O O O 
715 Get Cumulative Control Power Cycles - O O O O 
720 Get Inverter Rated Output Voltage - R R R R 
721 Get Inverter Rated Output Current - R R R R 
722 Get Inverter Rated Output Power - R R R R 


Attribute ID Offset, o = (n-1)*50 
5-46.5 Class Attributes 


The following table of attributes applies to the Motion Axis Object class, which may be 
referenced as instance 0. These attributes exist even before any Motion Axis Object instances 
have been created. Since they are not tied to any particular axis instance of a CIP Motion 
Device, the class attributes are generally used to address parametric behavior that applies to all 
axis instances, e.g. the communications node behavior. As instances of this class are created, 
they are given consecutive instance numbers starting at 1. 


Notes: 


1. No attributes associated with this object require Non-Volatile storage, so a “No” is implied 
for all attributes under the NV column. 

2. Vendor specific bits, and enumerations provide space for device vendors to provide 
additional product features. 
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Key to Table: (See Sections 5-46.3 and 5-46.4 for details.) 
(R) — Required bit or enumeration — must be supported in the implementation 
(O) — Optional bit or enumeration — support is left to vendor’s discretion 


Set* - Indicates the attribute is normally set by the CIP Motion connection data block and not 
by a Set service. 


Table 5-46.2 Class Attributes for the Motion Axis Object 


AttrID | Needin | Access | N Attribute Name Data Description of Attribute Semantics of Values 
Implem Rule | V Type 


1 thru 7 | These class attributes are optional and are described in Chapter 4 of the Volume 1 of the CIP Networks Library. 


10 Required Set* Controller Struct This attribute contains the See Semantics. 
Consumed consumed data structure 
Connection Data defined by the CIP Motion 
Controller-to-Device 
Connection. 


11 Required Set* Controller Produced | Struct This attribute contains the See Semantics. 
Connection Data produced data structure 


defined by the CIP Motion 
Device-to-Controller 
Node Control BYTE 
a 


i Connection. 
i Node Fault USINT 
17 Optional | Get i Node Alarm USINT 


Set* Contains bits used to control | See Semantics. 
the behavior of the associated 


device communications node. 


14 Required 


15 Required Get Contains bits used to indicate | See Semantics. 
the status of the associated 


device communications node: 


16 Required Get Contains numeric code of See Semantics. 
active node fault condition. 

The Node Fault Code is used 

to provide diagnostic detail to 


pin-point the source of the 


fault condition. 


Contains numeric code of the | See Semantics. 
current active alarm condition. 

The Node Alarm Code is used 

to provide diagnostic detail to 

pin-point the source of the 

alarm condition. 


18 Required Set* Controller Update UDINT 
Period 


Represents the period between | Nanoseconds 
updates of the controller that 

is also the period between CIP 

Motion Controller-to-Device 

Connection updates. 


19 Required Set* Controller Time LINT 


Offset 


This element represents the Nanoseconds 
64-bit value at the beginning 

of the Controller Update 

Period that is associated with 

the Controller Time Stamp 

value. The Controller Time 

Offset is the value that is 

added to the controller’s local 

clock to produce System 

Time. 
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AttrID | Needin | Access | N Attribute Name Data Description of Attribute Semantics of Values 
Implem Rule | V Type 


20 Controller Time This element represents the Nanoseconds (CIP Sync 


64-bit System Time value at | absolute) 
the beginning of the 


Controller Update Period 

when the controller’s update 

timer event occurred. It is 

calculated by the controller as 

the sum of the controller’s 

local clock value when update 

timer event occurred and the 

controller’s System Time 

Offset value given by 

Controller Time Offset. The 

Controller Time Stamp is 

therefore directly associated 

with the command data 

contained in the connection. 

The time stamp format is 

absolute and follows the CIP 

Sync standard with 0 

corresponding to January 1, 

1970. 

21 Controller Update Represents high limit delay # of Controller Update 
Delay High Limit threshold for a Controller-to- | Periods 

Device Connection update. 
This delay is specified in units 
of Controller Update Periods. 
Exceeding this limit results in 
a Control Update Fault. 


22 Controller Update Represents high limit delay # of Controller Update 
Delay Low Limit threshold allowed for a Periods 
Controller-to-Device 
Connection update. This delay 
is specified in units of 
Controller Update Periods. 
Exceeding this limit results in 


a Control Update Alarm. 


Sync Variance Represents the current Nanoseconds 
statistical variation of the 
System Time Offset value 
from the mean System Time 
Offset value. 


) 


Set 
Set 

et 
Set 


29 Sync Threshold Determines the threshold for | Nanoseconds 
the Observed Variance of Default: device 
System Time below which the | dependent minimum 
Motion Axis Object is value. 
considered synchronized. The 
Group Sync service uses this 
as a criterion for a successful 


response. 


a 
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Attr ID Needin | Access | N Attribute Name Data Description of Attribute 
Implem Rule | V Type 


| il 7 
| |i . 
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This value is the product of 
the number of networks hops 
the device is away from the 
grandmaster, as determined by 
the Time Sync object 
attribute, Steps Removed, and 
the time synchronization 
interval, as determined by the 
Time Sync object attribute, 
Sync Interval. 


This bit-mapped byte contains 
flags that determine the usage 
and format of the controller 
and device timing 
information. This value is 
derived from Time 
Configuration element sent by 
the controller in the 
Controller-to-Device 
Connection and becomes the 
Time Configuration value sent 
by the device in the Device- 
to-Controller Connection. 
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Semantics of Values 


Seconds 


Bit Field: 

0 = Update Period 

1 = Time Stamps 

2 = Time Diagnostics 
3-7 = Reserved 
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5-46.6 Semantics 
5-46.6.1 Attribute #10 - Controller Consumed Connection Data 


This attribute contains the consumed data structure defined by the CIP Motion Controller-to- 
Device Connection. The content of this dynamic data structure is updated by the controller at 
the Controller Update Period. This structure, outlined in the figure below, is dynamically 
defined by connection header data. Refer to the Connections section for a detailed description 
of the connection data structure. 


Figure 5-46.8 Controller Consumed Connection Data Format 


€ 32-bit Word > 


Controller-to-Drive Connection Format 


Connection Header 
Instance 1 Data Header 
Cyclic Data Block 
Cyclic Write Data Block 
Event Data Block 
Service Data Block 


Instance 2 Data Header 


5-46.6.2 Attribute #11 - Controller Produced Connection Data 


This attribute contains the produced data structure defined by the CIP Motion Device-to- 
Controller Connection. This dynamic data structure is updated by the CIP Motion Device and 
transmitted to the controller at the Controller Update Period. This structure, outlined in the 
figure below, is dynamically defined by connection header data. Refer to the Connections 
section for a detailed description of the connection data structure. 


Figure 5-46.9 Controller Produced Connection Data Format 


€ 32-bit Word > 


Drive-to-Controller Connection Format 


Connection Header 
Instance 1 Data Header 
Cyclic Data Block 
Cyclic Read Data Block 
Event Data Block 
Service Data Block 


Instance 2 Data Header 
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5-46.6.3 Attribute #14 — Node Control 


Contains bits used to control the behavior of the associated motion device communications 
node. 


Table 5-46.3 Node Control Bit Definitions 


Remote Control This bit is used to request that the CIP Motion Device turn over 
complete control to the controller. If this bit is clear, the CIP Motion 
Device is under the exclusive control of the local interface; the CIP 
Motion controller cannot affect the behavior of the device in any way 
other than to switch the device back to Remote Control mode. If the 
CIP Motion connection is lost while the device is under remote control, 
the device may then be controlled via the local interface. 


Bit 


Sync Control This bit is used by the controller to request synchronous operation of 
the CIP Motion Device. Synchronous operation is defined as having the 
device node’s local timer synchronized with System Time and that the 
device node start using the Controller Time Stamp and Time Offset to 
process the connection data and schedule future Device-to-Controller 
Connection updates. The Synchronous Control bit implies that the 
Controller Time Stamp and Time Offset values are valid. The bit shall 
remain set for the duration of synchronous operation. In asynchronous 
mode, there is no requirement for the local timer to be synchronized nor 
is time-stamping necessary. The associated time data is not valid 


Controller Data Valid | This bit must be set for the CIP Motion Device to process the instance 
data blocks. During the connection initialization sequence there may be 
a period of time where the connection data in the instance data blocks is 
not yet initialized. This condition can be recognized by the device by 
first checking this bit and finding it clear. 


Node Fault Reset This bit is used to request that the CIP Motion Device perform a reset 
of the communications node and attempt to clear the Node Fault bit. 
When the controller detects that the Node Fault bit is clear, the Node 
Fault Reset bit is cleared. If the communication fault persists, the Node 
Fault bit may stay set, in which case a power cycle or a complete 
reconfiguration process must be performed 


> 
uo 


Reserved 


a= 
fT} tae 


? 
N 


Vendor Specific 
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5-46.6.4 Attribute #15 — Node Status 


Contains bits used to indicate the status of the associated drive communications node: 


Table 5-46.4 Node Status Bit Definitions 


Bit Required Name Description 
Optional 


0 Remote The Remote Mode bit is used to indicate that the CIP Motion Device 
Mode has turned over total control to the controller. If this bit is clear, the 
device must not act on any data contained in the Controller-to-Device 
cyclic or service channels. 


1 Sync Mode 
synchronized. Synchronous operation is defined as having the CIP 
Motion Device’s local timer synchronized with System Time and that 
Device Time Stamp is valid. The bit shall remain set for the duration 
of synchronous operation. If the Sync Mode bit is clear the CIP 
Motion Device is said to be in Asynchronous mode. In Asynchronous 
mode, there is no requirement for the local timer to be synchronized 
nor is time-stamping necessary or even valid. 

2 Data Valid The Data Valid bit must be set for the controller to process the 
instance data blocks from the CIP Motion Device. During the 
connection initialization sequence there may be a period of time 
where the connection data in the instance data blocks is not yet 
initialized. This condition can be recognized by the controller by first 
checking this bit. 

3 Node Fault The Node Fault bit is used to indicate that the CIP Motion Device has 
detected one or more fault conditions related to the communications 
node. Specific fault conditions can be determined by the Node Fault 
attribute. If this bit is clear, there are no fault conditions present. The 
Node Fault bit may be cleared by setting the Node Fault Reset bit in 
Fault condition is present. 


5-46.6.5 Attribute #16 — Node Faults 


This attribute is an 8-bit fault code used to indicate the presence of specific fault condition 
associated with the device’s communications node. 


The Sync Mode bit indicates whether or not the CIP Motion Device is 


the CIP Motion Device is using the connection time stamps to process 
the connection data. The Sync Mode bit being set also implies that the 


the Node Control word. All associated axes are disabled when a Node 


Table 5-46.5 Node Fault Code Definitions 


j 
1 Control Update Fault 


2 Processor Watchdog 
Fault 


3 Hardware Fault 


Description 


Indicates that there is no fault condition currently present at the device 
communications node. 


The Control Update Fault bit is used to indicate that updates from the 
controller have been excessively late. 


The Processor Watchdog Fault indicates that the processor associated 
with this CIP Motion Device has experienced an excessive overload 
condition that has tripped the associated processor watchdog 
mechanism. 


The Hardware Fault indicates that the critical support hardware (FPGA, 
ASIC, etc.) associated with the device node has experienced a fault 
condition. 
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Code 


4 Data Format Error This fault indicates that an error has occurred in the data format 
between the controller and the device. Eg: a format revision mismatch 
would be one example which would set this fault. 


Description 


128-255 | Vendor Specific 


Attribute #17 — Node Alarms 


This attribute is an 8-bit alarm code used to indicate specific alarm conditions of the associated 
device’s communications node. Alarms do not result in any direct action. 


Table 5-46.6 Node Alarm Code Definitions 
0 No Alarm Indicates that there is no alarm condition currently present at 
the device communications node. 
Control Update Alarm | The Control Update Alarm bit is used to indicate that updates 
from the controller have been late. 


1 

2 Processor Overload The Processor Overload Alarm indicates that the processor 
Alarm associated with device is experiencing overload conditions 

that could eventually lead to a fault 


3 Sync Alarm Sync Alarm indicates that the Sync Variance has exceeded the 
Sync Threshold while the device is running in Sync Mode 
128-255 | Vendor Specific 


Instance Attributes 


This section lists all the supported attributes of a Motion Axis Object instance. Because of the 
large number of attributes listed in this section, an attempt has been made to organize the 
attributes by functional category. Each functional grouping may be further organized by first 
listing the object Status and Signal attributes, followed by the object Configuration attributes. 


Notes: 


1. Due to the large number of instance attributes supported by this object, 16-bit Attribute IDs 
are required. 


2. No attributes associated with this object require Non-Volatile storage, so a “No” is implied 
for all attributes under the NV column. 


3. Unless otherwise specified, all optional attributes default to 0. 

Key to Tables: (See Sections 5-46.3 and 5-46.4 for details.) 

(R) — Required bit or enumeration — must be supported in the implementation 
(O) — Optional bit or enumeration — support is left to vendor’s discretion 
Control Modes: 


P — Position Control 
V — Velocity Control 
T — Torque Control 
N — No Control 


Control Methods: 
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F — Frequency Drives (V/Hz or VFD) 
C — Closed Loop (Vector Control) 


Set* - Indicates the attribute is normally set by the CIP Motion connection header and not by a 
Set service. 


% Device Rated Units — defined as the percentage of the continuous rating of the device with 
100% implying operation at the continuous rated specification for the device. This unit can be 
applied to attributes related to speed, torque, force, current, voltage, and power. Applicable 
“Devices” can be Motor, Inverter, Converter, or Bus Regulator. Note that this unit can be used 
independent of whether the attribute value represents an instantaneous level or a time-averaged 
level; the appropriate unit for the device rating is implied. As with all attributes that are in units 
of %, an attribute value of 100 means 100%. 


Feedback Units: Attributes that relate to motion dynamics typically express displacement in 
terms of the selected feedback device count resolution. Since thedevice can use different 
feedback channels for different control loops depending on the feedback configuration, the 
determination of which feedback device applies depends on the Feedback Configuration. A 
cross-reference table is provided below to determine the appropriate feedback counts or units to 
apply to an attribute based on its Dynamic Unit type (position, velocity, or acceleration), and 
the configured Feedback Configuration. When an axis instance is configured for No Feedback, 
i.e. sensorless operation (V/Hz, sensorless velocity servo, or future stepper support), feedback 
counts do not apply, so motion dynamics must be expressed in terms of motor displacement. 


Table 5-46.7 Dynamic Unit vs. Feedback Configuration 


Feedback Configuration 


Dynamic Units No Feedback Feedback 1 Feedback 2 Dual Loop 
Feedback 

Position Control Motor Counts Feedback 1 Counts Feedback 2 Counts | Feedback 2 Counts 
Units 
Velocity Control Motor Units Feedback 1 Units Feedback 2 Units Feedback 1 Units 
Units 
Accel Control Feedback 1 Units Feedback 2 Units Feedback 1 Units 
Units 


Motion Control Configuration Attributes 


The following attribute table contains basic motion control configuration attributes associated 
with a Motion Axis Object instance. These attributes govern aspects of the overall behavior of 
the motion axis object. 


Set*- These attributes are generally updated via the cyclic Command Data Set of the 
Controller-to-Device Connection. When included as cyclic command data, these attributes 
should not be updated via a Set service. 
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Table 5-46.8 Motion Control Configuration Attributes 


Attr| Need in Access | N Attribute Name Data Description of Semantics of 
ID Implem Rule Vv Type Attribute Values 
80 | Required - Set* Control Mode BYTE Attribute that determines the See Semantics 
All general dynamic control behavior 
of the motion axis instance. 


81 | Required - Set Control Method Enumerated code that determines See Semantics 
All the basic motor control algorithm 
applied by the device to control the 
dynamic behavior of the motor. 


5-46.8.1 
5-46.8.2 


5-46.8.3 


Semantics 


Attribute #1 — Control Mode 


The Control Mode attribute consists of a 4-bit enumerated Motor Control field and 4-bits 
reserved for future expansion. 


Figure 5-46.10 Control Mode Bit Field 


€ 8-bit BYTE > 
Control Mode Bit Format 
Bit 4-7: Bits 0-3: Enumeration 
Reserved Motor Control 


The Motor Control field enumeration determines the specific dynamic behavior of the motor 
that the device is to control for this axis instance The system view of these control modes are 
described in detail in Chapter 5-46.2.3. Here is a brief summary of the Motor Control modes: 


Table 5-46.9 Motor Control Field Enumeration Definitions 


Enum. Req. Name Description 
Opt. 
0 R/N No Control No motor control is provided in this mode but interface to 
a specific feedback device as a master feedback source is 
possible via the Feedback Configuration attribute. 
R/P Position Control Drive seeks to control the position, or orientation, of the 
motor. 
O/C 


ra 


R/ Velocity Control Drive seeks to control the velocity of the motor. 
Acceleration Control | Drive seeks to control the acceleration of the motor. 
R/C Torque Control Drive seeks to control the torque output of the motor. 


| Current Control Drive seeks to control the torque producing current to the 
motor. 


Attribute #2 — Control Method 


The Control Method attribute is an 8-bit enumerated code that determines the basic control 
algorithm applied by the device to control the dynamic behavior of the motor associated with 
an axis instance. 


oy BR] Ww] NM 
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Table 5-46.10 Control Method Field Enumeration Definitions 


Enum. | Req. Description 


No Control No Control is associated with a Control Mode of No Control where there is 
no explicit motor control provided by the device for this axis instance. 


Opt. 
R/F Frequency Frequency Control is an “open loop” control method that applies voltage to 
Control the motor, generally in proportion to the commanded frequency or speed. 
This control method is associated with Variable Frequency Drives (VFDs) 


or so called Volts/Hertz drives. 


2 PI Vector PI Vector Control is a “closed loop” control method that uses actual or 
Control estimated feedback for closed loop cascaded PI control of motor dynamics, 
i.e. position, velocity, acceleration, and torque, and always includes 
independent closed loop PI control of Iq and Id components of the motor 
current vector. 
Motor Attributes 


The following attribute tables contain motor configuration attributes associated with a Motion 
Axis Object instance that apply to various motor technologies. These motor technologies 
include three-phase motor rotary, linear, permanent magnet and induction motors. Motor 
attributes are, therefore, organized according to the various motor types. The Need in 
Implementation category for an attribute is based on the context of the Motor Type and, thus, to 
the context of the table in which the attribute appears. Where needed, Standard vs. Optional can 
be further differentiated by abbreviations for PM (Permanent Magnet) and IM (Induction 
Motors). It is implied that these motor attributes are not required for No Control (Feedback 
Only) control mode. 


The goal of this motor attribute section is to define the minimal set of required attributes to 
support device interchangeability. This guarantees that there is sufficient parametric data 
provided by the controller for any drive compliant with the CIP Motion Device Profile, to 
effectively control a given motor. 


For induction motors, the Motion Axis Object leverages the IEEE recommended phase-neutral 
equivalent circuit motor model based on “Wye” configuration. Reactance values, X, are related 
to their corresponding Inductance values, L, by X = wL, where is the rated frequency of the 
motor. The prime notation, e.g. X2’, R2’, indicates that the actual rotor component values X2, 
and R2 are referenced to the stator side of the stator-to-rotor winding ratio. 


Figure 5-46.11 IEEE per Phase Motor Model 
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For permanent magnet motors, the Motion Axis Object assumes all motor parameters are 
defined in the context of a phase-to-phase motor model. 


5-46.9.1 General Motor Attributes 


The following attribute tables contain general motor attributes that apply to all motor 
technologies. 


Table 5-46.11 General Motor Info Attributes 


AttrID| Need in Access N Attribute Name Data Description of Semantics of Values 
Implem Rule Vv Type Attribute 


1310 | Optional Get Motor Catalog SHORT A 32-character string that 
Number STRING | specifies the motor catalog 
number. This attribute is not 
applicable when the Motor Data 
Source is Controller NV. 
1311 | Optional Get Motor Serial SHORT A 16-character string that e.g. 
Number STRING | specifies the serial number of 0012003400560078 
the motor. This attribute is 
applicable only when the Motor 
Data Source is Motor NV. 
1312 | Optional Get Motor Date Code SHORT A 16-character string that 
STRING | specifies the manufacturing date 
of the motor. This attribute is 
applicable only when the Motor 
Data Source is Motor NV. 


Table 5-46.12 General Motor Configuration Attributes 


AttrID| Needin Access Attribute Name Description of Semantics of Values 
Implem Rule Attribute 


1313 Motor Data Source An enumeration that specifies 
the source of motor data for the 0 = Controller NV (R) 
drive. Controller NV implies 1 = Drive NV (O) 
that the motor attributes are 2 = Motor NV (0) 
derived from the controller’s 3-127 = reserved 
non-volatile memory during the 128-255 = vendor 
drive configuration process. specific 


Drive NV implies that the motor 
attributes are derived directly 
from the drive’s non-volatile 
memory. In this mode, no motor 
parameters shall be sent by the 
controller to the drive. Motor 
NV implies that the motor 
attributes are derived from non- 
volatile memory of a motor- 
mounted smart feedback drive 
equipped with a serial interface. 
Again, in this mode, no motor 
parameters shall be sent by the 
controller to the drive. 


A unique number assigned to a 
motor catalog number. This 
value is used to insure that the 
motor and integral motor 
mounted feedback drive 
configuration data delivered 
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1315 


1316 


1317 


1318 


Need in Access 
Implem Rule 


| 


Set 
Set 
Se 

Set 


ae 
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Attribute Name Data 

Type 

Motor Type USINT 
Motor Unit UINT 

Motor Polarity USINT 
Motor Rated REAL 

Voltage 
= 5-429:— 
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Description of 
Attribute 


from the controller matches the 
actual motor and feedback data 
connected to the drive. This 
comparison is only valid in the 
case where the Motor Data 
Source is Controller NV but the 
motor is equipped with a smart 
feedback drive. If the codes do 
not match, a negative 
acknowledge is given by the 
drive. Motor Device Codes are 
assigned by the motor 
manufacturer. 


An enumeration that specifies 
the motor type. 


Unit of measure for motor 
displacement. This is also used 
for sensorless operation. 


An enumerated value used to 
establish the direction of motor 
motion in response to positive 
drive output. Normal polarity is 
defined as the direction of motor 
travel when the UVW motor 
leads are hooked up according to 
the drive’s published 
specifications. Reverse polarity 
effectively switches the UVW 
phasing to UWV so that the 
motor moves in the opposite 
direction in response to a 
positive drive output. This 
attribute can be used to make the 
direction of travel agree with the 
user’s definition of positive 
travel and can be used in 
conjunction with the Feedback 
Polarity bit to provide negative 
feedback, when closed loop 
control is required. 


A float that specifies the 
nameplate AC voltage rating of 
the motor. This represents the 
phase-to-phase voltage applied 
to the motor to reach rated speed 
at full load. 


ODVA & ControlNet International, Ltd. 


Semantics of Values 


Enumeration: 

0 = rotary permanent 
magnet (O) 

1 = rotary induction (O) 
2 = linear permanent 
magnet (O) 

3 = linear induction (O) 
4-127 = reserved 
128-255 = vendor 
specific 

Enumeration: 

0 = Rev 

1 = Meter 

2-127 = reserved 
128-255 = vendor 
specific 

Enumeration: 

0 = Normal Polarity 

1 = Reverse Polarity 


Volts (RMS) 


Attr ID 


1319 


1320 


1321 


1322 


1323 


1324 


1325 


Need in 
Implem 


Required — 
PM 
Optional - 
IM 


Required — 
IM 
Optional — 
PM 


Access 
Rule 
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Attribute Name 


Motor Rated 
Continuous 
Current 


Motor Rated Peak 
Current 


Motor Rated 
Output Power 


Motor Overload 
Limit 


Motor Integral 
Thermal Switch 


Motor Max 
Winding 
Temperature 


Motor Winding-to- 
Ambient Thermal 
Capacitance 


Data 


5 


REAL 


REAL 


REAL 


REAL 


BOOL 


REAL 


REAL 
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Description of 
Attribute 


A float that specifies the 
nameplate AC continuous 
current rating of the motor. This 
represents the current applied to 
the motor under full load 
conditions at rated speed and 
voltage. 


A float that specifies the peak or 
intermittent current rating of the 
motor. The peak current rating 
of the motor is often determined 
by either the thermal constraints 
of the stator winding or the 
saturation limits of PM motor 
magnetic material. 


A float that specifies the 
nameplate rated output power 
rating of the motor. This 
represents the power output of 
motor under full load conditions 
at rated current, speed and 
voltage. 


A float that specifies the 
maximum thermal overload limit 
for the motor. This value is 
typically 100%, corresponding 
to the power dissipated when 
operating at the continuous 
current rating of the motor, but 
can be significantly higher if 
cooling options are applied. For 
induction motors, this attribute is 
related to the Service Factor of 
the motor. When the Motor 
Capacity attribute value 
associated with the motor 
thermal model exceeds the 
Motor Overload Limit, the drive 
can optionally trigger a 
predetermined Motor Overload 
action. The Motor Overload 
Limit can also used by the drive 
to determine the absolute 
thermal capacity limit of the 
motor, i.e. the Motor Thermal 
Overload Factory Limit, that if 
exceeded, generates a Motor 
Thermal Overload FL exception. 


A boolean that specifies if the 
motor has an integral thermal 
switch. 


A float that specifies the 
maximum winding temperature 
of the motor. 


A float that specifies the 
winding-to-ambient thermal 
capacitance. 


Semantics of Values 


Amps (RMS) 


Amps (RMS) 


Watts 


% Motor Rated 


Joules/°C 
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AttrID| Need in Access N Attribute Name Data Description of Semantics of Values 
Implem Rule Vv Type Attribute 
1326 | Optional Set Motor Winding-to- A float that specifies the °C/Watt 
Ambient Thermal winding-to-ambient thermal 
Resistance resistance. 


5-46.9.2. General PM Motor Attributes 


The following attribute table contains motor configuration attributes that apply to Permanent 
Magnet motor types in general. 


Table 5-46.13 General PM Motor Configuration Attributes 
AttrID| Need in Access N | Attribute Name Data Description of Semantics of 
Implem Rule Vv Type Attribute Values 
1327 | Required Set PM Motor A float that specifies the phase- | Ohms 
Resistance to-phase, resistance of a 
permanent magnet motor. 
1328 | Required Set PM Motor A float that specifies the phase- | Henries 
Inductance to-phase, inductance of a 
permanent magnet motor. 


5-46.9.3 General Rotary Motor Attributes 


The following attribute table contains motor configuration attributes that apply specifically to 
rotary motor types. 


Table 5-46.14 General Rotary Motor Configuration Attributes 


Attr ID] Need in Access | N | Attribute Name Data Description of Semantics of 
Implem Rule Vv Type Attribute Values 


1329 | Required Set Rotary Motor An integer that specifies the number of 
Poles poles per revolution for rotary motors. 
This value is always an even number, as 
poles always exist in pairs. 


1330 | Optional Set Rotary Motor REAL A float that specifies the unloaded inertia | Kg-m? 
Inertia of a rotary motor. 


1331 | Required Set Rotary Motor A float that specifies the nameplate rated | RPM 
Rated Speed speed of a rotary motor at rated voltage 
and rated current. For induction motors 
this value is often referred to as base 
speed. The value also generally 
represents the speed at which the output 
power of the motor is maximized. 


1332 | Optional Set Rotary Motor A float that specifies the absolute RPM 

Max Speed maximum speed of a rotary motor in 
units of RPM. This speed may be 
determined by the limitations of the 
motor or by limitations of the 
mechanical system. Specifically, this 
value can represent the maximum safe 
operating speed, maximum continuous 
“no-load” speed, maximum continuous 
encoder speed, or maximum continuous 
bearing speed of the motor. This value 
can be used to determine the Motor 
Overspeed exception. 
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AttrID| Need in Access | N | Attribute Name Data Description of Semantics of 
Implem Rule Vv Type Attribute Values 
1333 | Optional Set Rotary Motor A float that specifies the damping, or N- 
Damping viscous friction, associated with arotary | meters/(radia 
Coefficient motor. n/second) 


5-46.9.4 General Linear Motor Attributes 


The following attribute table contains motor configuration attributes that apply specifically to 
linear motor types. 


Table 5-46.15 General Linear Motor Configuration Attributes 


AttrID| Need in Access N | Attribute Name Data Description of Semantics of Values 
Implem Rule Vv Type Attribute 


1334 | Required Set Linear Motor Pole A float that specifies the pole pitch | Meters 
Pitch of a linear motor in units of meters, 
and is equivalent to the electrical 
cycle length. 


1335 | Required Set Linear Motor A float that specifies the nameplate | Meters/sec 
Rated Speed rated speed of a linear motor at 

rated voltage and rated current. For 

induction motors this value is often 

referred to as base speed. The value 

also generally represents the speed 

at which the rated output power of 

the motor is measured.. 


1336 | Optional Set Linear Motor REAL A float that specifies the unloaded Kg 
Moving Mass moving mass of a linear motor. 


1337 | Optional Set Linear Motor Max A float that specifies the absolute Meters/sec 

Speed maximum speed of a linear motor 
in units of m/s. This speed may be 
determined by the limitations of the 
motor or by limitations of the 
mechanical system. Specifically, 
this value can represent the 
maximum safe operating speed, 
maximum continuous “no-load” 
speed, maximum continuous 
encoder speed, or maximum 
continuous bearing speed of the 
motor. This value can be used to 
determine the Motor Overspeed 
exception. 


1338 | Optional Set Linear Motor A float that specifies the damping, N/(m/s) 
Damping or viscous friction, associated with 
Coefficient a linear motor. 
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5-46.9.5 Rotary PM Motor Attributes 


The following attribute table contains motor configuration attributes that apply specifically to 
rotary motor types. 


Table 5-46.16 Rotary PM Motor Configuration Attributes 


AttrID| Need in Access | N Attribute Name Data Type Description of Semantics of Values 
Implem Rule Vv Attribute 
1339 | Required Set PM Motor Rated A float that specifies the 
Torque nameplate continuous torque 
rating of a rotary permanent 
magnet motor. 
1340 | Required Set PM Motor Torque A float that specifies the torque N-m/Amp (RMS) 
Constant constant of a rotary permanent 
magnet motor in Newton-meters 
per RMS Amp. 
1341 | Required Set PM Motor Rotary A float that specifies the voltage, | Volts (RMS) / KRPM 
Voltage Constant or back-EMF, constant of a 
rotary permanent magnet motor 
in phase-to-phase RMS Volts 
per KRPM. 


5-46.9.6 Linear PM Motor Attributes 


The following attribute table contains motor configuration attributes that apply specifically to 
linear PM motor types. 


Table 5-46.17 Linear PM Motor Configuration Attributes 


AttrID| Need in Access N Attribute Name Data Description of Semantics of Values 
Implem Rule Vv Type Attribute 
1342 | Required Set Motor Rated Force A float that specifies the 
nameplate continuous force 
rating of a linear permanent 
magnet motor. 
1343 | Required Set Motor Force A float that specifies the force N/Amp (RMS) 
Constant constant of a linear permanent 
magnet motor in Newtons per 
RMS Amp. 
1344 | Required Set Motor Linear A float that specifies the voltage, | Volts (RMS) / (m/s) 
Voltage Constant or back-EMF, constant of a 
linear permanent magnet motor 
in phase-to-phase RMS Volts per 
meter/sec. 


5-46.9.7. Induction Motor Attributes 


The following attribute table contains motor configuration attributes that apply specifically to 
induction motor types. 
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Table 5-46.18 Induction Motor Configuration Attributes 
AttrID| Need in Access N Attribute Name Data Description of Semantics of Values 
Implem Rule Vv Type Attribute 
1345 | Required Induction Motor REAL A float that specifies the Hertz 


Rated Frequency nameplate frequency rating of an 
induction motor. 
1346 | Required S 


Id Current Reference that Amps (RMS) 
required to generate full motor 

flux. This value is closely 

approximated by the No Load 

Motor Rated Current commonly 

found in Induction Motor data 

sheets. 


A float that specifies the Y Ohms 
circuit, phase-neutral, winding 

resistance of the stator as shown 

as R1 in the IEEE motor model. 


Induction Motor REAL 


Flux Current 


1347 | Required 


1348 | Required 


et 
Set 
Set 
1349 | Required* Set 
Set 
Set 
at rated frequency, as shown as 


1351 | Required 
X2’ in the IEEE motor model. 


* These parameters have a strong motor temperature component that some drives circumvent through various adaption or compensation 
techniques. Nevertheless these parameters are classified as required for the purposes of drive interoperability. 


Induction Motor REAL 


Stator Resistance 


Induction Motor REAL 
Stator Leakage 


Reactance 


A float that specifies the Y Ohms 
circuit, phase-neutral, leakage 

reactance of the stator winding, 

at rated frequency, as shown as 

X1 in the IEEE motor model. 


A float that specifies the Y Ohms 
circuit, phase-neutral, 

magnetizing reactance of the 

motor, at rated frequency, as 


Induction Motor REAL 
Magnetization 


Reactance 


shown as Xm in the IEEE motor 
model. 


1350 | Required* Induction Motor REAL 


Rotor Resistance 


A float that specifies the phase- Ohms 
neutral equivalent stator- 

referenced winding resistance of 

the rotor as shown as R2’ in the 

IEEE motor model. 


A float that specifies the Y Ohms 
circuit, phase-neutral, equivalent 
stator-referenced leakage 

inductance of the rotor winding, 


REAL 


Induction Motor 
Rotor Leakage 
Reactance 


5-46.10 Feedback Attributes 


The following attribute tables contain all position feedback related attributes associated with a 
Motion Axis Object instance that apply to various feedback device and feedback interface 
technologies. These feedback interface technologies include Digital AqB (digital A quad B 
signals), Sine/Cosine (analog A quad B signals), Digital Parallel (parallel digital bit interface), 
SSI (Synchronous Serial Interface), LDT (Linear Displacement Transducer) and Resolver. 
Other modern feedback interfaces supported are Hiperface® (by Stegmann) and EnDat 2.1®@ & 
EnDat 2.2® (by Heidenhain). The “Need in Implementation” category for an attribute is based 
on the context of the Feedback Type abbreviations for TT (Digital AqB), TP (Digital Parallel), 
SC (Sine/Cosine), HI (Hiperface®), E21 (EnDat 2.1®), E22 (EnDat 2.2®), SS (SSI), LT (LDT 
— Linear Displacement Transducer, and RS (Resolver). The abbreviation HS applies to all 
devices that support Hall Sensors. 
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The goal of this feedback attribute section is to define the minimal set of required attributes to 
support device interchangeability. This guarantees that there is sufficient parametric data 
provided by the controller for any drive compliant with the CIP Motion Drive Profile to 
effectively interface to a wide range of feedback device types. 


Multiple feedback device interfaces are currently defined by the Motion Axis Object for control 
loop feedback, namely Feedback 1 and Feedback 2. In dual feedback control configurations, 
Feedback 1 is generally associated with the motor mounted feedback device while Feedback 2 
is associated with the load-side or machine mounted feedback device. For all other control 
modes, Feedback 1 must be used for the singular feedback interface and is always required for 
PM Motor commutation. 


When No Control is selected for a Motion Axis Object instance, any uncommitted feedback 
channel can be used as a master feedback source. Since Feedback 1 is typically assigned to the 
control function of the primary Motion Axis Object instance, Feedback 2, 3, 4, etc., are likely 
candidates as master feedback sources. For this version of the Motion Axis Object, two 
additional feedback channels, Feedback 3 and Feedback 4, are supported for this purpose. 


To minimize the length of the feedback attribute tables below, the letter “n” in the generic 
“Feedback n” attribute name is used to specify the associated feedback channel number. Valid 
channel numbers for open standard feedback attributes of the Motion Axis Object are 1, 2, 3, 
and 4. Attribute IDs are assigned based on the channel number. Support for feedback interface 
channels, 2, 3, 4 is optional in the device implementation. However, if hardware support for 
any of these feedback channels is available in a given device, these optional attributes are 
clearly required in the implementation for the channels to be available for use. 


Table 5-46.19 General Feedback Info Attributes 


GENERAL FEEDBACK INFO ATTRIBUTES 


Attr ID Need in Access | N Attribute Data Type Description of Semantics of Values 
Implem Rule Vv Name Attribute 
1400 + Optional - | Get Feedback n SHORT A 32-character string that e.g. 
(n-1)*50 | All Catalog STRING specifies the catalog number of 
Number the device associated with 
Feedback n. 
1401 + Optional - | Get Feedback n SHORT A 16-character string that e.g. 
(n-1)*50 | All Serial Number | STRING specifies the serial number of 0012003400560078 
the device associated with 
Feedback n. 
1402 + Required Feedback n DINT Actual position of the axis Feedback n Counts 
Position based on Feedback n. 


(n-1)*50 | -NPVC 
Optional - 
T 
Feedback n REAL Actual filtered velocity of the Feedback n Units / Sec 
Velocity axis based on Feedback n. 
Feedback n REAL Actual filtered acceleration of Feedback n Units / 
Acceleration the axis based on Feedback n. Sec’ 


Get 
1403 + Required | Get 
(n-1)*50 | -NPVC 
et 
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Optional - 
T 


1404 + Required | G 
(n-1)*50 | -NPVC 
Optional - 
T 


84 


1411+ 
(n-1)*50 


Optional - 
PC 


Optional - 
NC 
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Table 5-46.20 Feedback Configuration Attributes 


Attr ID Need in Access N Attribute Data Description of Semantics of Values 
Implem Rule Vv Name Type Attribute 


90 Required Set* 
—PVT 


82 Required - | Set* 
All 

83 Required - | Set* 
All 


Feedback Data 
Set 


Feedback 
Configuration 


Feedback 
Master Select 


Feedback 1/2 
Count Ratio 


Feedback n 
Unit 


BYTE 


BYTE 
USINT 


REAL 


USINT 
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Bit mapped field that 
determines what actual 
feedback data values are 
being transmitted to the 
controller in the Drive-to- 
Controller connection. 


This attribute determines 
how the various available 
feedback channels are 
used to implement the 
selected Control Mode. 


This attribute determines 
what Logical channel is 
assigned to this axis 
instance when the 
Feedback Configuration is 
set to Master Feedback. 


Number of Feedback 1 
Counts per Feedback 2 
Counts. This value is used 
to convert between 
feedback 2 counts to 
feedback 1 counts when 
configured for dual 
position loop operation. 


Unit of measure for the 
designated feedback 
device. The Feedback Unit 
for Feedback 1 must be 
scalable to the configured 
Motor Unit; if the Motor 
Unit is set to Rev, 
Feedback 1 Unit must be 
set to Rev; if Motor Unit 
is set to Meter, Feedback 1 
Unit must be set to either 
Meter or Inch and the 
drive must handle 
conversion between the 
linear motor and feedback 
displacement units. 


Bit Field: 

0 = Position Feedback 
(R/C) 

1 = Velocity Feedback 
(RIC) 

2 = Accel Feedback (O) 
3 = Torque Reference 
(R/T) 

4 = Iq Current Reference 
(O) 

5 = Voltage Output (O) 
6 = Frequency Output (O) 
7 = Reserved 


See Semantics 


Enumeration: 
0 = Reserved 
1 = Feedback 1 
2 = Feedback 2 


3 = Feedback 3 
4 = Feedback 4 


Feedback 1 Counts per 
Feedback 2 Count 


Enumeration: 
0 = Rev 

1 = Meter 

2 = Inch 


3-255 = reserved 
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Attr ID Need in Access N Attribute Data Description of 
Implem Rule Vv Name Type Attribute 


Feedback n 


Optional Set 
(n-1)*50 Port Select 


1412 + 


1413 + 
(n-1)*50 


Required Set Feedback n 
Type 
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Maps the logical Feedback 
Channel “n” to a physical 
Feedback Port “m”. 
Default Feedback n Port 
Select =n. 


Identifies the type of 
feedback device connected 
to the associated Feedback 
interface. Drive support 
for any individual 
feedback types is left to 
the discretion of the drive 
manufacturer. However if 
a specific feedback type is 
supported, attributes 
associated with that type 
are generally required in 
the implementation. 


ODVA & ControlNet International, Ltd. 


Semantics of Values 


Enumeration: 
0 = Reserved 
1 = Port 1 
2 = Port 2 


3 = Port 3 
4= Port 4 
5-255 = Reserved 


Enumeration: 

0 = No Feedback Present 
1 = Digital AqB (w/o 
Hall) 

2 = Digital AqB (w/ Hall) 
3 = Digital Parallel 
(Absolute) 

4 = Sine/Cosine (w/o Hall) 
5 = Sine/Cosine (w/ Hall) 
6 = Hiperface ® 

7 = EnDat 2.1 ® 

8 = EnDat 2.2 ® 


9 = Resolver 

10 = SSI 

11=LDT 

12-127 = reserved 
128-255 = vendor specific 
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Attr ID 

1414+ Optional Set 
(n-1)*50 

1415 + 

(n-1)*50 


|] 


Feedback n 


Mode 


Need in Access N Attribute Data Description of 

Implem Rule Vv Name Type Attribute 
Feedback n 
Polarity 


An enumerated value used 
to establish the direction 
of change in the feedback 
counter in response to 
positive motion of the 
associated feedback 
device. Normal polarity is 
defined as that which 
results in increasing 
feedback counts when the 
feedback device is hooked 
up and moved in the 
positive direction 
according to the drives 
published specifications. 
Reverse polarity internally 
switches the polarity of 
the feedback accumulator 
so that the feedback 
counts decrease when the 
feedback device moves in 
the positive direction. This 
attribute can be used to 
make the direction of 
travel agree with the 
user’s definition of 
positive travel and can be 
used in conjunction with 
the Motor Polarity bit to 
provide negative feedback, 
when this feedback 
channel is used for closed 
loop control. 


Determine how the drive 
applies the feedback count 
value. 


When configured for 
Incremental mode, the 
drive zeroes the feedback 
count accumulator at 
power-up. 

When configured for 
Absolute mode, the drive 
initializes the feedback 
count accumulator at 
power-up to the absolute 
feedback position value 
read from the feedback 
device. 
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Semantics of Values 


Enumeration: 
0 = Normal Polarity 
1 = Reverse Polarity 


Enumeration: 
0 = Incremental 
1 = Absolute 
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Attr ID Need in Access N Attribute Data Description of Semantics of Values 
Implem Rule Vv Name Type Attribute 


1416 + Feedback n Number of feedback Feedback Cycles / 
(n-1)*50 Cycle cycles per Feedback Unit. | Feedback Unit 
Resolution Cycles for a Digital AgB 

device is the “line” 

resolution of the encoder, 

while it represents the 

sinusoidal “cycle” 

resolution of a Sin/Cos 

feedback device and the 

“pole” count of Resolver 

feedback device. For 

digital serial (e.g. SSI) or 

parallel absolute feedback 

device interfaces, this 

value would represent the 

“step” resolution of the 


device. 
1417 + Required - Feedback n Number of interpolated Feedback Counts / 
(n-1)*50 TT, SC, Cycle Feedback Counts per Feedback Cycle 


HI, E21, Interpolation Feedback Cycle. For a 

RS Digital AqB device the 
drive’s feedback interface 
hardware can generally 
support interpolation 
values of 1, 2, or 4. Fora 
Sin/Cos, Hiperface, Endat 
2.1, or Resolver feedback 
device the number is 
generally much larger and 
determined by the 
interpolation capability of 
the drive feedback 
interface hardware. A 
value of 1024 is typical in 
this case. For digital serial 
(e.g. SSI) or parallel 
absolute feedback device 
interfaces, this value is 
always 1 since there is no 
opportunity of drive-based 
interpolation. The 
effective resolution of the 
feedback device in 
Feedback Counts per 
Feedback Unit is the 
product of the Feedback 
Cycle Resolution and the 
Feedback Cycle 
Interpolation. 


1420 + Required Feedback n Number of feedback data # of Bits 
(n-1)*50 | — TP, SS, Data Length bits transferred over the 
HI, E21, digital serial or parallel 
E22 data interface channel of a 
feedback device. 
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Attr ID 


1421+ 
(n-1)*50 


1422 + 


(n-1)*50 


1423 + 
(n-1)*50 


1424 + 


(n-1)*50 


1425 + 


(n-1)*50 


1426 + 
(n-1)*50 


1427 + 
(n-1)*50 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 6 


Motion Axis Object, Class Code: 42hex 


Need in Access N Attribute Data Description of Semantics of Values 
Implem Rule Vv Name Type Attribute 


Optional — 
TP, SS 


Optional - 
RS 


Optional - 
RS 


Optional - 
RS 


Optional - 
RS 


ee - 


Required - 
LT 


Feedback n 
Data Code 


Feedback n 
Resolver 
Transformer 
Ratio 


Feedback n 
Resolver 
Excitation 
Voltage 


Feedback n 
Resolver 
Excitation 
Frequency 


Feedback n 
Resolver Cable 
Balance 


Feedback n 
LDT Type 


Feedback n 
LDT 
Recirculations 


USINT 


REAL 


REAL 


REAL 


REAL 


USINT 


USINT 
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Enumeration: 
0 = Binary 
1 = Gray 


Type of feedback data bit 
encoding used by 
designated serial or 
parallel data interface 
channel of a feedback 
device. 


Transformer Ratio 

specification of the 
designated resolver 
feedback device. 


Sets the sinusoidal 
excitation voltage applied 
to the rotor of the 
designated resolver 
feedback device. 


Volts (RMS) 


Frequency of sinusoidal Hertz 
excitation signal applied to 

the designated resolver 

feedback device. Valid 

frequency range or values 

for this attribute depends 

on the specific drive 

hardware interface. 


Adjusts the relative 
amplitude of the Sine and 
Cosine signals from the 
resolver to compensate for 
impact of resolver cable. 


Enumeration: 

0= PWM 

1 = Start/Stop Rising 
2 = Start/Stop Falling 


Determines the LDT type. 
Options are Start/Stop and 
PWM. Start/Stop 
transducers accept an 
input (interrogate) signal 
to start the measurement 
cycle and respond with 
two pulses on the Return 
line. Timing can be based 
on either the Rising or 
Falling edge. The time 
between the pulses is 
proportional to the 
position. PWM 
transducers respond to the 
interrogate signal with a 
single long pulse on the 
Return line. The pulse 
width is proportional to 
the position. 


Determines the number of | # Recirculations 
recirculations associated 

with a PWM type LDT 

transducer. Multiple 

recirculations can be used 

to increase the resolution 

of the LDT at the expense 

of increasing the sample 

period. 
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Attr ID Need in Access N Attribute Data Description of Semantics of Values 
Implem Rule Vv Name Type Attribute 


1428 + Required Set Feedback n A value that specifies the Electrical Degrees 
(n-1)*50 | — HS, TP, Commutation commutation offset of the 

HI, E21, Offset PM motor mounted 

E22, SS, feedback device in units of 

RS electrical degrees. This 

(PM attribute specifies the 

Motors offset from a commutation 

Only) reference position defined 
by applying DC current 
into the U terminal and out 
of the shorted V and W 
terminals of the motor and 
allowing the rotor to move 
to its magnetic null 
position relative to the 
stator. On an absolute 
encoder or resolver, the 
offset is the difference 
from the device’s zero 
absolute position and the 
commutation reference 
position. On an 
incremental encoder with 
Hall sensors, the offset is 
the difference between the 
position corresponding to 
a transition of the Hall S3 
channel (with the $1 
channel high and the S2 
channel low) and the 
commutation reference 
position. The 
commutation offset is only 
applicable to the motor 
mounted Feedback 1 
device. 


1434 + Optional Set Feedback n Controls the bandwidth of | Radians/sec 
(n-1)*50 Velocity Filter the Low Pass Filter 
Bandwidth. applied to the raw velocity 
signal from Feedback n. A 
value of 0 for this attribute 
disabled this feature. 
1435 + Optional Set Feedback n Controls the bandwidth of | Radians/sec 
(n-1)*50 Accel Filter the Low Pass Filter 
Bandwidth applied to the raw 
acceleration signal from 
Feedback n. A value of 0 
for this attribute disabled 
this feature. 
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5-46.10.1 Semantics 
5-46.10.2 Attribute #3 — Feedback Configuration 


5-46.11 


This attribute contains a 4-bit enumerated Feedback Selection field that determines how the 
various logical feedback channels are used to implement the selected Control Mode for this 
axis instance. 


Figure 5-46.12 Feedback Configuration Bit Field 


€ 8-bit BYTE > 
Control Mode Bit Format 
Bit 4-7: Bits 0-3: Enumeration 
Reserved Feedback Selection 


Feedback Selection enumerations provide support for multi-feedback control functionality for 
the various active Control Modes, i.e. where the device is actively controlling the motor based 
on feedback. In these active Control Modes it is assumed that logical channel, Feedback 1, is 
attached directly to the motor while Feedback 2 is attached to the load side of the mechanical 
transmission. Commutation signals for a PM motor are always derived from the Feedback 1. 


Table 5-46.21 Feedback Selection Field Enumeration Definitions 


Enum. | Req. Opt. Description 


0 R/NF O/C | No Feedback No Feedback is selected when sensorless open loop or closed 
loop control is desired. When performing open loop control, 
no feedback signal is required. In closed loop control, the 
required feedback signal is estimated by a sensorless control 
algorithm based on motor phase voltage and current signals.. 


1 R/N Master Feedback Master Feedback assigns an uncommitted feedback channel, 
as specified by the Feedback Master Select attribute, to this 
motion axis instance to serve as a “master feedback” source 
when the drive is configured for No Control mode 


Motor Feedback When Motor Feedback is selected, then commutation, 
acceleration, velocity, and position feedback signals are all 
derived from motor mounted Feedback 1 


3 O/C Load Feedback When Load Feedback is selected, then motor-mounted 
Feedback 1 is only used for PM motor commutation while 
load-side Feedback 2 is used for position, velocity, and 
acceleration. 


4 O/P Dual Feedback When Dual Feedback is selected, then motor mounted 
Feedback 1 is used for commutation, acceleration, and 
velocity, and load-side Feedback 2 is used strictly for 
position. 


Event Capture Attributes 


The following attribute tables contain all event related attributes associated with a Motion Axis 
Object instance. These include registration, marker, and homing events. The Event Capture 
attributes are designed to support the possibility of up to 16 active events per controller update 
period. The format of all Time Stamp attributes is absolute System Time and follows the CIP 
Sync standard with 0 corresponding to January 1, 1970. 
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The Motion Axis Object currently supports two independent registration input channels per 
axis instance that can be triggered on either the rising of falling edges of the signal. If the 
device hardware implementation allows, event time and position data can be captured for all 
four event conditions simultaneously. The Event Capture attributes also support Auto-rearm for 
registration events. This allows for controller implementation of important features like 
Windowed Registration and Registration Pattern Recognition. 


The Motion Axis Object also supports Home Switch, Marker and Switch-Marker events for 
homing functionality on a per axis basis. The Marker events are typically generated by the 
configured position feedback device for the associated axis instance. 


Set* - These attributes are generally updated via the cyclic Command Data Set of the 
Controller-to-Device Connection. When included as cyclic command data, these attributes 
should not be updated via a Set service. 


Table 5-46.22 Event Attributes 


Attr ID Need in N | Attribute Name | Data Description of Attribute 
Implem Vv Type 


Semantics of Values 


256 


257 


258 


259 


260 


261 


Optional — NP 


Optional — NP 


Required — 
NP 

Required — 
NP 

Optional — NP 
Optional — NP 


Get 


Event Checking 
Control 


Event Checking 
Status 


Registration 1 
Positive Edge 
Position 


Registration 1 
Negative Edge 
Position 


Registration 2 
Positive Edge 
Position 


Registration 2 
Negative Edge 
Position 


This attribute is passed to the 
drive by the controller as part 
of the Drive to Controller 
connection for the purpose of 
arming various drive inputs, 
e.g. marker, home switch, 
and registration inputs, to 
generate events to the 
controller. When these 
enabled events occur, the 
drive captures both the time 
and exact axis position when 
the event occurred. 


This attribute is passed to the 
drive by the controller as part 
of the Drive to Controller 
connection to indicate if the 
drive is currently checking 
for events based on various 
drive inputs, e.g. marker, 
home, and registration inputs. 
Event checking is initiated 
when the corresponding 
Event Checking Control bit is 
set in the controller to drive 
connection. 


Feedback position latched on 
the rising edge of the 
Registration Input 1. 


Feedback Position latched on 
the falling edge of the 
Registration Input 1. 


Feedback position latched on 
the rising edge of the 
Registration Input 2. 


Feedback Position latched on 
the falling edge of the 
Registration Input 2. 


See Semantics 


See Semantics 


Position Control U 


Position Control U 


Position Control U 


Position Control U 


nits 


nits 


nits 


nits 
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Attr ID Need in Access | N | Attribute Name | Data Description of Attribute Semantics of Values 
Implem Rule Vv Type 
262 Optional — NP | Get Registration 1 LINT System Time stamp on the Nanoseconds (CIP Sync 
Positive Edge rising edge of the absolute) 
Time Registration Input 1. 
263 Required — Get Registration 1 System Time stamp on the Nanoseconds (CIP Sync 
NP Negative Edge falling edge of the absolute) 
Time Registration Input 1. 
264 Required — Get Registration 2 System Time stamp on the Nanoseconds (CIP Sync 
NP Positive Edge rising edge of the absolute) 
Time Registration Input 2. 
Registration 2 System Time stamp on the Nanoseconds (CIP Sync 


Negative Edge 


falling edge of the 


absolute) 


265 Optional — NP | Get 
Registration Input 2. 
266 Required — Get Home Event DINT | Feedback Position latched on | Position Control Units 
NP Position the specified home event. 
268 Optional — NP | Get Home Event LINT System Time stamp latched Nanoseconds (CIP Sync 
Time on the specified home event. | absolute) 
5-46.11.1 Semantics 


5-46.11.2 Attribute #256 — Event Checking Control 


The first 28-bits of this 32-bit attribute are used to enable various device inputs, e.g. marker, 
home switch, and registration inputs, to generate events to the controller. When these enabled 
events occur, the device captures both the time and exact position of the associated motion axis 
instance. The most significant 4-bits represent the number of Event Acknowledgement 
messages are in the Event Data Block in the last Controller-to-Device Connection update. For a 
detailed description of the event handling protocol between the drive and the controller refer to 
Connection section in the appropriate CIP Motion device profile. 


Time 


Figure 5-46.13 Event Checking Control Word Field 


€ 32-bit DWORD > 
Event Checking Control Format 

Bits 0-27: Bit Field 
Event Checking Control Bits 


Bit 28-31 
Event Acknowledgement Blocks 


For the Home Switch-Marker events shown in the figure below, the device first looks for level 
of home switch input to transition according to the first + or — symbol and then immediately 
look for the transition of the marker input according to the second + or — symbol. 


Table 5-46.23 Event Checking Control Bit Definitions 


Bit Req. Name Description 
Opt. 
0 R/P Reg 1 Pos Edge Enable checking for positive edge transition of Registration 1 Input 
1 R/P Reg 1 Neg Edge Enable checking for negative edge transition of Registration 1 
Input 
2 O/P Reg 2 Pos Edge Enable checking for positive edge transition of Registration 2 Input 
3 O/P Reg 2 Neg Edge Enable checking for negative edge transition of Registration 2 
Input 
4-7 Reserved 
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Bit Req. Name 
Opt. 
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Description 


8 O/P Reg 1 Pos Auto-rearm | Enable auto-rearm mechanism after positive edge transition of 
Registration 1 Input 
9 O/P Reg 1 Neg Auto-rearm | Enable auto-rearm mechanism after negative edge transition of 
Registration 1 Input 
10 O/P Reg 2 Pos Auto-rearm | Enable auto-rearm mechanism after positive edge transition of 
Registration 2 Input 
11 O/P Reg 2 Neg Auto-rearm | Enable auto-rearm mechanism after negative edge transition of 
Registration 2 Input 
12-15 Reserved 
16 R/P Marker Pos Edge Enable checking for positive edge of Marker input of associated 
position feedback channel. 
17 R/P Marker Neg Edge Enable checking for negative edge of Marker input of associated 
position feedback channel. 
18 R/P Home Switch Pos Enable checking for positive edge of Home input associated with 
Edge this axis instance. 
19 R/P Home Switch Neg Enable checking for positive edge of Home input associated with 
Edge this axis instance. 
20 R/P Home Switch-Marker Enable checking for event sequence specified as a positive edge 
++ transition of the Home Switch input followed by a positive edge of 
the Marker input. 
21 R/P Home Switch-Marker Enable checking for event sequence specified as a positive edge 
+- transition of the Home Switch input followed by a negative edge of 
the Marker input. 
22 R/P Home Switch-Marker - | Enable checking for event sequence specified as a negative edge 
+ transition of the Home Switch input followed by a positive edge of 
the Marker input. 
23 R/P Home Switch-Marker - | Enable checking for event sequence specified as a negative edge 
- transition of the Home Switch input followed by a negative edge of 
the Marker input. 
24-27 Reserved 


5-46.11.3 Attribute #257 — Event Checking Status 


The first 28-bits of this 32-bit attribute are used to indicate if the device is currently checking 
for events based on various device inputs, e.g. marker and registration inputs. Event checking is 
initiated when the corresponding event checking control bit is set in the Controller-to-Device 
Connection. When an event occurs, the device captures both the time and exact axis position 
and passes this information to the controller in event notification data blocks. But for the 
controller to process the event data, the corresponding event checking status bit must be set. 
The most significant 4-bits of this attribute represent the number of Event Notification 
messages are in the Event Data Block in the last Device-to-Controller Connection update. For a 
detailed description of the event handling protocol between the device and the controller refer 
to Connection section. 


Figure 5-46.14 Event Checking Status Word Field 


€ 32-bit DWORD > 


Event Checking Status Format 


Bit 28-31 


Event Notification Blocks 


Bits 0-27: Bit Field 
Event Checking Status Bits 
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Bit 


1 
N 


12-15 


21 


22 


23 


24-27 


5-46.12 
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Table 5-46.24 Event Checking Status Bit Definitions 


Reg 1 Pos Edge Checking for positive edge transition of Registration 1 Input? 


aE 


Reg 1 Neg Edge Checking for negative edge transition of Registration 1 Input? 


Reg 2 Pos Edge Checking for positive edge transition of Registration 2 Input? 


Reg 2 Neg Edge Checking for negative edge transition of Registration 2 Input? 


Reg 1 Pos Auto-rearm Auto-rearm mechanism after positive edge transition of Registration 
1 Input active? 

Reg 1 Neg Auto-rearm Auto-rearm mechanism after negative edge transition of Registration 
1 Input active? 

Reg 2 Pos Auto-rearm Auto-rearm mechanism after positive edge transition of Registration 
2 Input active? 

Reg 2 Neg Auto-rearm Auto-rearm mechanism after negative edge transition of Registration 
2 Input active? 


R/P Marker Pos Edge Checking for positive edge of Marker input of associated position 
feedback channel? 
Marker Neg Edge Checking for negative edge of Marker input of associated position 
feedback channel? 
Home Switch Pos Edge Checking for positive edge of Home input associated with this axis 
instance? 


Home Switch Neg Edge Checking for positive edge of Home input associated with this axis 
instance? 


R/P 
R/P 
O/P 
O/P 
O/P 
O/P 
O/P 

/P 


O 


Home Switch-Marker ++ | Checking for event sequence specified as a positive edge transition 
of the Home Switch input followed by a positive edge of the Marker 
input? 


Home Switch-Marker + Checking for event sequence specified as a positive edge transition 
of the Home Switch input followed by a negative edge of the Marker 
input? 

Home Switch-Marker -+ | Checking for event sequence specified as a negative edge transition 
of the Home Switch input followed by a positive edge of the Marker 
input? 


Home Switch-Marker -- Checking for event sequence specified as a negative edge transition 
of the Home Switch input followed by a negative edge of the Marker 
input? 


a) as) ~~ as) ~ ~~ ~ 


Command Reference Generation Attributes 


The following lists of attributes apply to the command reference generation functionality of the 
device that converts command position, velocity, acceleration, and torque data output from a 
controller-based planner into corresponding command references signals to the device’s motor 
control structures. The command reference generator functionality includes fine interpolators, 
signal selector switches, dynamic limiters. 


Set* - These attributes are generally updated via the cyclic Command Data Set of the 
Controller-to-Device Connection. When included as cyclic command data, these attributes 
should not be updated via a Set service. 
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Table 5-46.25 Command Generator Signal Attributes 


Attr ID} Need in Implem N | Attribute Name Data Description of Attribute Semantics of Values 
Vv Type 
93 


Required — P Command Target | LINT Time stamp associated with Nanoseconds (CIP Sync 
command data from the motion | absolute) 
planner and used by the 

command fine interpolators. 

The Command Target Time is 

the sum of the Controller Time 

Stamp value and the Command 

Target Update interval 

associated with this axis 

instance. The time stamp 

format is absolute and follows 

the CIP Sync standard with 0 

corresponding to January 1, 

1970. 


Command position data value Position Control Units 
from controller, updated at the 

Controller Update Period, and 

feeding into a fine interpolator. 


Optional - VT Time 


286 Controller 
Position 
Command 


DINT 


287 Required — V Controller 
Optional — P Velocity 
Command 


REAL | Command velocity data value Velocity Control Units / 
from controller, updated at the Sec 
Controller Update Period, and 


feeding into a fine interpolator. 


288 Controller 
Acceleration 
Command 


REAL Command acceleration data Accel Control Units / 


value from controller, updated Sec’ 
at the Controller Update Period, 

and feeding into a fine 

interpolator. 


289 Controller Torque | REAL 


Command 


Optional - P Interpolated 
Command 
Position 


291 Optional - PV Get Interpolated 
Command 
Velocity 

292 Optional - PVT Get Interpolated 
Command 
Acceleration 


— 5-447 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Commanded torque data value % Motor Rated 
from controller, updated at the 

Controller Update Period, and 

feeding into a fine interpolator. 


290 DINT Output value from the Position Control Units 
Command Position fine 


interpolator. 


REAL Output value from the Velocity Control Units / 
Command Velocity fine Sec 

interpolator. When no 

Command Velocity signal is 

present when performing 

position control, this signal can 

be derived by scaling the 

Differential Position output 

value of the Command Position 


fine interpolator. 


REAL Output value from the Accel Control Units / 
Command Acceleration fine Sec? 
interpolator. When no 

Command Acceleration signal 

is present when performing 

position or velocity control, this 

signal can be derived by scaling 

the Differential Velocity output 

value of the Command Velocity 

fine interpolator. If no 

Command Velocity signal is 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 6 


Motion Axis Object, Class Code: 42hex 


Attr ID| Need in Implem Access N | Attribute Name Data Description of Attribute Semantics of Values 
Rule Vv Type 


present, the Interpolated 
Command Acceleration signal 
can be derived by scaling the 
2™ Differential Position output 
value of the Command Position 
fine interpolator. 


Table 5-46.26 Command Generator Configuration Attributes 


Attr ID| Need in Implem Access N | Attribute Name Data Description of Attribute Semantics of Values 
Rule Vv Type 


Command Data 
Set 


91 Required — PVT 


92 Required — PV 


Interpolation 
Control 


Positive 


Velocity Limit - 
Negative 


Velocity Limit - 


Bit mapped field that Bit Field: 

determines what command data | 0 = Position Command 
values are being updated by the | (R/P) 

controller. 1 = Velocity Command 
(R/V) 

2 = Accel Command (O) 
3 = Torque Command 
(R/T) 

4 = Position Trim (O) 

5 = Acceleration Trim 
(O) 

6 = Velocity Trim (O) 
7 = Torque Trim (O) 


Controls the See Semantics 
interpolation/extrapolation 

method applied to position, 

velocity, and acceleration 

command data from the motion 

planner based on the associated 

time stamp. 


This value defines the Velocity Control Units / 
maximum allowable positive Sec 

velocity command into the 

velocity summing junction. If 

this velocity limit value is 

exceeded, the device responds 

by clamping the velocity 

command to this limit and 

setting the Velocity Limit 

status bit. 


This value defines the Velocity Control Units / 
maximum allowable negative Sec 

velocity command into the 

velocity summing junction. If 

this velocity limit value is 

exceeded, the devicee responds 

by clamping the velocity 

command to this limit and 

setting the Velocity Limit 

status bit. 


302 Required — V Set 
Optional - P 
303 Required — V Set 
Optional - P 
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Attr ID| Need in Implem Access N | Attribute Name Data Description of Attribute Semantics of Values 
Rule Vv Type 


304 Required — V Set Acceleration This value defines the Velocity Control Units / 
Optional - P Limit maximum allowable positive Sec? 
rate of change in the magnitude 
of the velocity command 
(increasing speed). If this 
acceleration limit value is 
exceeded, the device responds 
by clamping the rate of change 
of the velocity command to this 
limit and setting the 
Acceleration Limit status bit. 
305 Required — V Set Deceleration This value defines the Velocity Control Units / 
Optional - P Limit maximum allowable negative Sec? 
rate of change in the magnitude 
of the velocity command 
(decreasing speed). If this 
deceleration limit value is 
exceeded, the device responds 
by clamping the rate of change 
of the velocity command to this 
limit and setting the 
Deceleration Limit status bit. 


306 Optional - PV Set Jerk Limit Control When accel or decel limited, 
this value sets the percentage 
of accel or decel time that is 
applied to the speed ramp as 
jerk limited S Curve. The S 
Curve time is added % at the 
beginning and ¥% at the end of 
the ramp. A value of 0 results 
in no S-Curve, i.e. a linear 
acceleration ramp. A value of 
100% results in a triangular 
acceleration profile with the 
peak being the 
acceleration/deceleration limit. 
As the Jerk Limit Control value 
increases the derived Jerk limit 
value decreases. 
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7 


308 


309 


310 


311 


Optional — P 


Optional - F 
Optional - F 
Optional - F 


Optional - F 


Attr ID| Need in Implem 
30 V 


Set 


Set 


Set 
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Flying Start BOOL 


Enable 


Skip Speed 1 REAL 
Skip Speed 2 REAL 
Skip Speed 3 REAL 


Skip Speed Band REAL 
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This Boolean value is used to 
enable or disable the Flying 
Start feature of the device. 
When Flying Start Enabled is 
true and the motion axis is 
enabled, the device determines 
the current velocity of the 
motor as part of the Starting 
State initialization activities. 
Just prior to transitioning to the 
Running state, the device 
presets the output of the Accel 
Limiter to the current velocity. 
In this way, the motor 
seamlessly ramps from its 
current velocity to the 
commanded velocity profile 
generated by the motion 
planner. When Flying Start 
Enabled is false, the motor 
velocity is not determined and 
a preset of 0 is applied to the 
Accel Limiter output. 


Sets the central speed of a skip 
speed band within which the 
drive does not operate. 


Sets the central speed of a skip 
speed band within which the 
drive does not operate. 


Sets the central speed of a skip 
speed band within which the 
drive does not operate. 


Determines the speed window 
around a skip speed that cannot 
be commanded. Any command 
set-point within this window is 
adjusted by the Skip Speed 
block to fall at either the upper 
or lower Skip Speed Band 
boundary value. The axis can 
smoothly accelerate or 
decelerate through the skip 
speed band based on the 
acceleration limiter block but 
may not operate at a set speed 
within the band. The Skip 
Speed Band is distributed % 
above and % below the skip 
speed. This Skip Speed Band 
attribute applies to all skip 
speeds supported in the device. 
A value of 0 for this attribute 
disabled this feature. 


ODVA & ControlNet International, Ltd. 


False = Flying Start 


Disabled 


True = Flying Start 


Enabled 


Velocity Control U 
Sec 


Velocity Control U 
Sec 


Velocity Control U 
Sec 


Velocity Control U 
Sec 


nits / 


nits / 


nits / 


nits / 
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5-46.12.1 Semantics 
5-46.12.2 Attribute #301 — Interpolation Control 


The Interpolation Control attribute governs the interpolation/extrapolation method applied to 
position, velocity, and acceleration command data from the motion planner based on the 
associated time stamp. The first two bits of this 8-bit attribute represent the Command Target 
Update that determines the number of Update Periods (UP) added to the command data Time 
Stamp to determine the absolute System Time that the command data value is targeted for, i.e. 
the Command Target Time. For more details on interpolation and extrapolation control, please 
refer to the Section 6.6.2 on Command Fine Interpolation. 


Figure 5-46.15 Interpolation Control Word Field 


€ 8-bit BYTE > 
Event Checking Status Format 
Bits 0-1: Enumeration 


Bits 6-7: Vendor Specific Bits 2-5: Reserved its O-1: i 
Command Target Update 


Table 5-46.27 Command Target Update Enumeration Definition 


Immediate A Command Target Update of 0 implies that the command 
data is to be applied to the drive control structure 
immediately. 


A Command Target Update of 1 implies that extrapolation 
is to be used to apply the command data to the drive control 
structure based on adding 1 Update Period to the command 
Time Stamp. 


A Command Target Update of 2 implies that fine 
interpolation is to be used to apply the command data based 
on adding 2 Update Periods to the command Time Stamp. 


5-46.13. Control Mode Attributes 
5-46.13.1 Position Loop Attributes 


The following attributes tables contain all position control related attributes associated with a 
Motion Axis Object instance. 


Set* - this attribute is generally updated via the cyclic command data set of the Controller-to- 
Device connection. When included as cyclic command data this attribute should not be updated 
via a Set service. 


Table 5-46.28 Position Loop Signal Attributes 


Attr ID Need in Access | N Attribute Name Data Description of Attribute Semantics of Values 
Implem Rule Vv Type 


420 Required— | Get Position Command Command position output Position Control 
P from the fine interpolator (if | Units 
active) into position loop 
when configured for position 
loop control. 
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Attr ID Need in Access Attribute Name Data Description of Attribute 
Implem Rule Type 


421 Required — Position Trim DINT Additional position 
P command added to the 
Position Command to 
generate the Position 
Reference signal into the 
position loop summing 
junction. 
422 Required — Position Reference DINT Command position reference 
P signal into the position loop 
summing junction to be 
compared with a position 
feedback signal. 


423 Required — Velocity Feedforward | REAL Velocity feedforward 
PC Command reference into velocity loop 
summing junction. 


424 Required — Position Feedback DINT Position feedback value 
NPVC channeled into the position 
Optional — control summing junction. 
T 


426 Required — Position Error REAL Error between commanded 
PC and actual position that is 
the output of the position 
loop summing junction. 
427 Required — Position Integrator REAL Output of position integrator 
PC Output representing the contribution 
of the position integrator to 
Position Loop Output. 
428 Required — Position Loop Output | REAL Output of the position loop 
PC forward path representing 
the total control effort of the 
position loop. 


Attr ID ea || of 
ea || 


430 Velocity Feedforward Gain 
value that multiplies the 
Velocity Feedforward 
Command signal before 
applying it to the velocity 
loop summing junction. 


431 Required — Position Proportional Gain 
PC value that multiplies the 
Position Error signal before 
applying it to the velocity 
loop summing junction. 


432 a - Position Integral Gain value 
that multiplies the Position 
Integrator Error signal 
before applying it to the 
velocity loop summing 
junction. 
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Semantics of Values 


Position Control 
Units 


Position Control 
Units 


Velocity Control 
Units / Sec 


Position Control 
Units 


Position Control 
Units 


Velocity Control 
Units / Sec 


Velocity Control 
Units / Sec 


Semantics of Values 


Radians/Sec 


Radians/Sec* 


Position Control 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 6 


Motion Axis Object, Class Code: 42hex 


AttrID| Need in Attribute Name Description of Semantics of Values 
Implem Attribute 
PC Tolerance command position. When Units 
the actual position is within 
this window the Position 
Lock status bit is set. When 
actual position falls outside 
this window, the Position 
Lock status bit is cleared. 
Required — Position Error Determines the absolute Position Control 
PC Tolerance maximum Position Error Units 
value that can be tolerated 
without causing an 
Excessive Position Error 
exception. 
435 Optional — Position Error Determines the maximum Sec 
PVC Tolerance Time amount of time that the 
Position Error Tolerance can 
be exceeded without 
generating an exception. 


439 Required — Position Integrator This bit field controls the Bit Field: 
PC Control behavior of the position loop | 0: Integrator Hold 
integrator while Enable 
commanding motion via the | 1: Auto-preset 
controller. When the 
integrator hold enable bit is 
set, the integrator is held 
while motion is being 
commanded with a non-zero 
velocity. When clear, the 
integrator runs without 
qualification. When the 
auto-preset bit is set, the 
integrator preload value is 
automatically loaded with 
the current velocity 
command when there is a 
control mode change 
between velocity control and 
position control. If clear, the 
integrator is loaded with the 
configured position 
integrator preload value. 


434 


440 Required - Position Integrator Value assigned to the Velocity Control 
PC Preload position integrator when the | Units / Sec 
position control loop is 
enabled. 


5-46.13.2 Velocity Loop Attributes 


The following attributes tables contain all velocity control related attributes associated with a 
Motion Axis Object instance. 


Set* - this attribute is generally updated via the cyclic command data set of the Controller-to- 
Drive connection. When included as cyclic command data this attribute should not be updated 
via a Set service. 
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Table 5-46.30 Velocity Loop Signal Attributes 


Attr ID Need in Access N Attribute Name Data Description of Attribute 
Implem Rule Vv Type 


450 Required — PV Get Velocity Command REAL Command velocity output 
from fine interpolator (if 
active) into velocity loop 
when configured for 
velocity loop control. 

451 Required — PV Velocity Trim REAL Additional velocity 
command added to the 
velocity loop summing 
junction. 

452 Required — Acceleration REAL Acceleration feedforward 

PVC Feedforward Command reference into acceleration 
loop summing junction. 

453 Required — PV Velocity Reference REAL Command velocity 
reference into velocity loop 
summing junction. 


454 Required — Velocity Feedback REAL Actual velocity of the axis 
NPVC Optional applied to the velocity 
-T summing junction based on 
Control Mode selection. 


455 Required — Velocity Error REAL Error between the velocity 
PVC reference and velocity 
feedback value that is the 
output of the velocity loop 
summing junction. 
456 Required — Velocity Integrator REAL Output of velocity integrator 
PVC Output representing the 
contribution of the velocity 
integrator to Velocity Loop 
Output. 
457 Required — Velocity Loop Output REAL Output of velocity forward 
PVC path representing the total 
control effort of the velocity 
loop. 


Table 5-46.31 Velocity Loop Configuration Attributes 


Attr ID Need in Access N Attribute Name Data Description of Attribute 
Implem Rule Vv Type 
460 Required — PC Set Kaff REAL Acceleration Feedforward 
Gain value that multiplies 
the Acceleration 
Feedforward Command 
signal before applying it to 
the velocity loop summing 
junction. 
461 Required — Set Kvp REAL Velocity Proportional Gain 
PVC value that multiplies the 
Velocity Error signal before 
applying it to the 
acceleration summing 
junction. 
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Semantics of Values 


Velocity Control 
Units / Sec 


Velocity Control 
Units / Sec 


Velocity Control 
Units / Sec2 


Velocity Control 
Units / Sec 


Velocity Control 
Units / Sec 


Velocity Control 
Units / Sec 


Accel Control Units / 
Sec? 


Accel Control Units / 
Sec? 


Semantics of Values 


% 


Radians/Sec 
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Attr ID Need in Access N Attribute Name Data Description of Attribute | Semantics of Values 
Implem Rule Vv Type 


462 Required — Set Kvi REAL Velocity Integral Gain Radians /Sec* 
PVC value that multiplies the 
Velocity Integrator Error 
signal before applying it to 
the acceleration summing 
junction. 


464 Required — V Set Kdr REAL Velocity Droop value that Velocity Control 
Optional — P provides compliance to the | Units / % Rated 
velocity integrator by 
subtracting a portion of the 
velocity loop effort from 
the velocity error input to 
the velocity integrator. The 
presence of the 
Torque/Force scaling gain, 
Kj, in the droop signal path 
allows Velocity Droop to be 
specified in velocity units 
per % rated torque output. 
This parameter is also valid 
for V/Hz drives and its 
behavior is nearly identical, 
but instead of % rated being 
related to torque, % rated is 
related to current. 


465 Optional — PVC | Set Velocity Error REAL Determines the absolute Velocity Control 
Tolerance maximum Velocity Error Units/ Sec 
value that can be tolerated 
without causing a Excessive 
Velocity Error exception. 
466 Optional — PVC | Set Velocity Error REAL Determines the maximum Sec 
Tolerance Time amount of time that the 
Velocity Error Tolerance 
can be exceeded without 
generating an exception. 


467 Required — Set Velocity Integrator BYTE This bit field controls the Bit Field: 
PVC Control behavior of the velocity 0: Integrator Hold 
loop integrator while Enable 
commanding motion via the | 1: Auto-preset 
controller. When the 
integrator hold enable bit is 
set, the integrator is held 
while motion is being 
commanded with a non- 
zero velocity. When clear, 
the integrator runs without 
qualification. When the 
auto-preset bit is set, the 
integrator preload value is 
automatically loaded with 
the current torque command 
when there is a control 
mode change between 
torque control and velocity 
control. If clear, the 
integrator is loaded with the 
configured velocity 
integrator preload value. 
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Attr ID Need in Access N Attribute Name Data Description of Attribute | Semantics of Values 
Implem Rule Vv Type 


468 Velocity Integrator Value assigned to the Accel Control Units / 
PVC 


Preload velocity integrator when the | Sec? 
velocity control loop is 
enabled. 
469 Optional — PVC 
Optional — PV 
Optional — PV 
this window, the Velocity 
Lock status bit is cleared. 
472 Required — PV S Velocity Standstill This value establishes a Velocity Control 
Window window around zero speed. | Units / Sec 
When the actual velocity is 
within this window the 
Velocity Standstill status bit 
is set. When actual speed 
falls outside this window, 
the Velocity Standstill 
status bit is cleared. 


5-46.13.3 Acceleration Control Attributes 


Set 
Set Velocity Low Pass Controls the bandwidth of Radians/sec 
Filter Bandwidth. the Low Pass Filter applied 
to the Velocity Error signal. 
Recommended 
implementation is a two 
pole IIR filter. A value of 0 
for this attribute disabled 
this feature. 
470 Set 
Set 
et 


which, results in the 
Velocity Threshold status 


bit being set. 


471 Velocity Lock This value establishes a Velocity Control 
Tolerance window around the current Units / Sec 
command velocity. When 
the actual velocity is within 
this window the Velocity 
Lock status bit is set. When 


actual position falls outside 


Velocity Threshold Defines a minimum Velocity Control 
absolute velocity, below Units / Sec 


The following attributes tables contain all accelerations related attributes associated with a 
Motion Axis Object instance. 


Set* - this attribute is generally updated via the cyclic command data set of the Controller-to- 
Device connection. When included as cyclic command data this attribute should not be updated 
via a Set service. 
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Table 5-46.32 Acceleration Control Signal Attributes 


Need in Access | N Attribute Name Data Description of Attribute 
Implem Rule Vv Type 


Optional - C Get Acceleration REAL Command acceleration output | Accel Control Units / 
Command from fine interpolator (if Sec? 
active) into acceleration loop 
when configured for 
acceleration control. 
Optional - C Set* Acceleration Trim Additional acceleration Accel Control Units / 
command added to the Sec’ 
acceleration loop summing 
junction. 
Optional - C Get Acceleration Command acceleration Accel Control Units / 
Reference reference into acceleration Sec? 
loop summing junction. 


Required — Get Acceleration Actual acceleration of the axis | Accel Control Units / 
NPVC Feedback based on the selected feedback | Sec? 
Optional — T device. 


5-46.13.4  Torque/Force Reference Attributes 


Attr ID Semantics of Values 


The following attributes tables contain all torque/force related attributes associated with a 
Motion Axis Object instance. 


Set* - this attribute is generally updated via the cyclic command data set of the Controller-to- 
Device connection. When included as cyclic command data this attribute should not be updated 
via a Set service. 


Table 5-46.33 Torque/Force Reference Signal Attributes 


Attr ID Need in Access | N Attribute Name Data Description of Attribute Semantics of Values 
Implem Rule Vv Type 


490 Required—C | Get Torque Command Command torque output from | % Motor Rated 
fine interpolator (if active) 
into torque input summing 
junction when configured for 
toque control. 
491 Required—C | Set* Torque Trim Additional torque command % Motor Rated 
added to the torque input 
summing junction. 
492 Required — C Torque Reference Commanded torque reference | % Motor Rated 
input signal before torque 
filter section representing the 
sum of the Torque Command 
and Torque Trim signal 
inputs. 
493 Required — C Filtered Torque Commanded torque reference | % Motor Rated 
Reference input signal after torque filter 
section. 
494 Required — C Limited Torque Commanded torque reference | % Motor Rated 
Reference input signal after torque 
limiter section. 
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Table 5-46.34 Torque/Force Reference Configuration Attributes 


Attr ID Need in Access | N Attribute Name Data Description of Attribute Semantics of Values 
Implem Rule Vv Type 


496 Required — Set kj REAL Torque/Force Scaling Gain % Motor Rated / 
PVC value that converts (Accel Units/Sec’) 
commanded acceleration into 
equivalent rated torque/force. 
Properly set, this value 
represents the total system 
inertia. 
498 Optional—C | Set Friction REAL Value added to the % Motor Rated 
Compensation current/torque command to 
offset the effects of coulomb 
friction. 
502 Optional—C | Set Torque LP Filter REAL Break frequency for the 2" Radians/sec 
Bandwidth order low pass filter applied 
to torque reference signal. 


503 Optional—C | Set Torque Cmd Notch | REAL Center frequency of the notch | Radians/sec 
Freq. filter applied to the toque 
reference signal. A value of 0 
for this attribute disabled this 
feature. 
504 Required—C | Set Torque Limit - REAL Determines the maximum % Motor Rated 
Positive positive torque that can be 
applied to the motor. If the 
drive attempts to exceed this 
value, the torque command is 
clamped to this value. 
505 Required—C | Set Torque Limit - REAL Determines the maximum % Motor Rated 
Negative negative torque that can be 
applied to the motor. If the 
drive attempts to exceed this 
value, the torque command is 
clamped to this value. 


506 Optional - C Set Torque Rate Limit REAL Limits the rate of change of % Motor Rated / Sec 
the torque reference signal. 


507 Optional—C | Set Torque Threshold REAL Defines a maximum absolute | % Motor Rated 
torque level that, when 
exceeded, results in the 
Torque Threshold status bit 
being set. 


508 Optional—C | Set Overtorque Limit REAL Maximum limit for the % Motor Rated 
Torque Reference signal that 
when exceeded for the 
duration specified by 
Overtorque Limit Time 
attribute, results in an 
Overtorque Limit exception. 
This feature allows the drive 
to generate an exception if 
there is a sudden increase in 
load torque during operation. 
This condition could occur if 
a bearing fails or there is 
some other mechanical 
failure. 
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Attr ID Need in Access | N Attribute Name Data Description of Attribute Semantics of Values 
Implem Rule Vv Type 
509 Optional—C | Set Overtorque Limit REAL Specifies the amount of time | Sec. 
Time allowed in an Overtorque 
Limit condition before 
generating an Overtorque 
Limit exception. A value of 0 
for this attribute disabled the 
Undertorque feature. 
510 Optional—C | Set Undertorque Limit REAL Minimum limit for the % Motor Rated 
Torque Reference signal that 
when exceeded for the 
duration specified by 
Undertorque Limit Time 
attribute, results in an 
Undertorque Limit exception. 
This feature allows the drive 
to generate an exception if 
there is a sudden decrease in 
load torque during operation. 
This condition could occur if 
a load coupling breaks, 
tensioned web material 
breaks, etc. 
511 Optional—C | Set Undertorque Limit REAL Specifies the amount of time | Sec. 
Time allowed in an Undertorque 
Limit condition before 
generating an Undertorque 
Limit exception. A value of 0 
for this attribute disabled the 
Undertorque feature. 


5-46.13.5 Current Loop Attributes 


The following attributes tables contain all current loop related attributes associated with a 
Motion Axis Object instance. 


Table 5-46.35 Current Loop Signal Attributes 


Attr ID Need in Access | N Attribute Name Data Description of Attribute Semantics of Values 
Implem Rule Vv Type 


520 Required — C Get Iq Current Command Represents the % Motor Rated 
instantaneous value of the 
commanded torque 
producing current signal, 
Iq, prior to passing through 
the current limiter. 


521 Optional — C Get Operative Current Represents the operative % Motor Rated 
Limit current limit based on 
multiple limit sources. 
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Attr ID 


522 


523 


524 


525 


527 


528 


529 


530 


531 


532 


533 


Need in 
Implem 


Optional — C 


Required — C 


Optional — C 


Optional — C 


Optional — C 


Optional — C 


Optional — C 


Optional — C 


Optional — C 


Optional — C 


Optional — C 
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Access | N Attribute Name Data Description of Attribute 
Rule Vv Type 
Get 


ai 
wei 
aa 


Current Limit Source 


Motor Electrical 
Angle 


Iq Current Reference 


Id Current Reference 


Iq Current Error 


Id Current Error 


Iq Current Feedback 


Id Current Feedback 


Iq Decoupling 


Id Decoupling 


Vq Voltage Output 


USINT 


REAL 


REAL 


REAL 


REAL 


REAL 


REAL 


REAL 


REAL 


REAL 


REAL 
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Represents the operative 
source of a torque limit 
should a current limit 
condition occur. 


Calculated electrical angle 
of the motor based on 
motor pole count, 
commutation offset, and 
selected feedback device. 


Current reference signal, 
Iq, into the torque current 
loop summing junction. 


Command current 
reference, Id, into the flux 
current loop summing 
junction. 


Error between commanded 
and actual current that is 
the output of the torque 
producing, q-axis, current 
loop summing junction. 


Error between commanded 
and actual current that is 
the output of the flux 
producing, d-axis, current 
loop summing junction. 


Actual torque current 
applied to the axis based on 
current sensor feedback. 


Actual flux current applied 
to the axis based on current 
sensor feedback. 


Signal added to the Iq 
control loop output to 
compensate for the effects 
of Id. 


Signal added to the Id 
control loop output to 
compensate for the effects 
of Iq. 


Instantaneous 
Torque/Force producing 
output voltage. 


Semantics of Values 


Enumeration: 

0 = Not Limited 

1 = Inverter Peak 
Current Limit 

2 = Motor Peak 
Current Limit 

3 = Inverter Thermal 
Current Limit 

4 = Motor Thermal 
Current Limit 

5 = Shunt Regulator 
Limit 

6 — 127 = reserved 
128 — 255 = vendor 
specific 


Degrees 


% Motor Rated 


% Motor Rated 


% Motor Rated 


% Motor Rated 


% Motor Rated 


% Motor Rated 


% Motor Rated 


% Motor Rated 


% Motor Rated 
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Attr ID Need in Access | N Attribute Name Data Description of Attribute 
Implem Rule Vv Type 

534 Optional — C Get Vd Voltage Output REAL Instantaneous Flux 
producing output voltage. 

535 Optional — C Get U Voltage Output REAL Instantaneous voltage 
applied to U phase 

536 Optional — C Get V Voltage Output REAL Instantaneous voltage 
applied to V phase 

537 Optional — C Get W Voltage Output REAL Instantaneous voltage 
applied to W phase 

538 Optional — C Get U Current Feedback REAL Instantaneous current 
measured on U phase 

539 Optional — C Get V Current Feedback REAL Instantaneous current 
measured on V phase 

540 Optional — C Get W Current Feedback | REAL Instantaneous current 
measured on W phase 

541 Optional — C Get U Current Offset REAL Offset for U Phase current 
transducer. 

542 Optional — C Get V Current Offset REAL Offset for V Phase current 
transducer. 

543 Optional — C Get W Current Offset REAL Offset for W Phase current 
transducer. 


Table 5-46.36 Current Loop Configuration Attributes 


Attr ID} NeedinImplem | Access | N Attribute Name Data Description of 
Rule Vv Type Attribute 
554 Optional — C Get Kap REAL Iq Proportional Gain value 
that multiplies the Iq 
Current Error signal before 
applying it to the Iq 
decoupling summing 
junction. 
555 Optional — C Get Kgi REAL Iq Integral Gain value that 
multiplies the Iq Current 
Error signal before applying 
it to the Iq Integrator Error 
accumulator. 
556 Optional — C Get Kdp REAL Id Proportional Gain value 
that multiplies the Id 
Current Error signal before 
applying it to the Iq 
decoupling summing 
junction. 
557 Optional — C Get Kdi REAL Id Integral Gain value that 
multiplies the Id Current 
Error signal before applying 
it to the Id Integrator Error 
accumulator.. 
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Semantics of Values 


% Motor Rated 


Volts 


Volts 


Volts 


Amps 


Amps 


Amps 


Amps 


Amps 


Amps 


Semantics of Values 


Radians/Sec 


Radians/Sec? 


Radians/Sec 


Radians/Sec* 
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Attr ID} NeedinImplem | Access | N Attribute Name Data Description of Semantics of Values 
Rule Vv Type Attribute 


558 Optional — IM Set Flux Up Control When the motion axis is Enumeration: 
enabled, DC current is 0 = No Delay 
applied to an induction 1 = Manual Delay 
motor to build stator flux 2 = Automatic Delay 
before transitioning to the 
Running state. This 
attribute controls how an 
induction motor is to be 
fluxed in the Starting state 
prior to transitioning to the 
Running state. If No Delay 
is selected the axis 
transitions immediately to 
the Running state while the 
motor flux is building. With 
Manual Delay, the axis 
remains in the Starting state 
for the Flux Up Time to 
allow time for the motor to 
be fully fluxed. With 
Automatic Delay, the drive 
determines the amount of 
time to delay to fully flux 
the motor based on motor 
configuration attribute data 
or measurements. 


559 Optional — IM Set Flux Up Time REAL Sets the amount of time the | Sec 
drive allows to build full 
motor flux before 
transitioning to the Running 
state. 


5-46.13.6 Frequency Control Attributes 


The following attributes tables contain all related attributes associated with the Frequency 
Control method of operation of a Motion Axis Object instance. 


Table 5-46.37 Frequency Control Signal Attributes 
Attr ID Need in Access N Attribute Name Data Description of Semantics of Values 
Implem Rule Vv Type Attribute 
570 Required - F Get Slip Compensation Indicates the actual amount of RPM 
slip compensation currently 
being applied. 
Table 5-46.38 Frequency Control Configuration Attributes 


Attr ID Need in Access N Attribute Name Data Description of Semantics of Values 
Implem Rule Vv Type Attribute 


575 Required - F Set Frequency Control The Basic Volts/Hertz control Enumeration 
Method method applies voltage to the 0 = basic volts/hertz 
motor generally in direct (R/F) 
proportion to the commanded 1-127 = reserved 
frequency or speed. 128-255 = vendor 
specific 
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Attr ID Need in Access N Attribute Name Data Description of Semantics of Values 
Implem Rule Vv Type Attribute 


571 Required - F Set Rated Slip Speed REAL Represents the amount of slip RPM 
at motor rated current (full 
load) and motor rated 
frequency. 


572 Required - F Set Maximum Voltage REAL Sets the highest phase-to-phase | Volts (RMS) 
voltage the drive can output. 
573 Required - F Set Maximum Frequency | REAL Sets the highest frequency the Hertz 
drive can output. 
574 Required - F Set Frequency Limit REAL Sets the frequency limit which Hertz 
is generally set above the 
Velocity Limit, translated to 
frequency, to allow for slip 
compensation. 
575 Required - F Set Break Voltage REAL Sets the phase-to-phase output Volts (RMS) 
voltage of the drive at the 
Break Frequency where boost 
ends. 
576 Required - F Set Break Frequency Sets the output frequency of the | Hertz 
drive at the Break Voltage 
where boost ends. 
577 Required - F Set Start Boost REAL Sets phase-to-phase voltage Volts (RMS) 
boost level for starting and 
accelerating. 
578 Required - F Set | Run Boost REAL Sets the phase-to-phase voltage | Volts (RMS) 
5-46.13.7 Drive Output Attributes 


boost level for steady-state 
speed or deceleration. 


The following attributes tables contain all related attributes associated with the output of the 
drive inverter to the motor. 


Table 5-46.39 Drive Output Attributes 


Attr ID Need in Access N Attribute Name Data Description of Semantics of Values 
Implem Rule Vv Type Attribute 
600 Required - Get Output Frequency REAL Time averaged output Hertz 
PVT frequency applied to motor. 
601 Required - Get Output Current REAL Total time averaged output Amps (RMS) 
PVT current applied to motor. 


602 Required - Get Output Voltage Total time averaged phase-to- | Volts (RMS) 
PVT phase output voltage applied 
to motor. 


603 Required - Get Output Power REAL Total time averaged output Kilowatts 
PVT power of the motor. This value 
is based on the product of the 
Torque Reference signal and 
the Velocity Feedback. 


— 5-463 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 6 


Motion Axis Object, Class Code: 42hex 


Attr ID Need in Access | N Attribute Name Data Description of Semantics of Values 
Implem Rule Vv Type Attribute 


604 Optional - Set PWM Frequency UINT Sets the carrier frequency for Hertz 

PVT the Pulse Width Modulation 
output to the motor. Drive 
derating is required at higher 
PWM frequencies due to 
switching losses. Current loop 
update time is tied directly to 
the PWM frequency so loop 
performance generally 
increases with increasing 
PWM rate. 


5-46.14 Stopping & Braking Attributes 


The following attributes tables contain all active stopping and braking related attributes 
associated with a Motion Axis Object instance. 


Table 5-46.40 Stopping/Braking Attributes 


Attr ID) NeedinImplem | Access | NV | Attribute Name Data Description of Semantics of Values 
Rule Type Attribute 


610 Required -PVT Set Stopping Mode USINT When initiating a drive disable | See Semantics 
or a fault, this value determines 
the stopping method to apply to 
the motor. The final state after 
the stopping method is applied 
is the Stopped state. In the 
Stopped state the drive’s 
inverter power structure should 
either be Disabled (Disable 
selection) and free of torque or 
actively held (Hold selection) 
in a static condition via servo 
action. 
611 Required - PVT Set Stopping Current When initiating a drive disable, | % Motor Rated 
this value determines the 
maximum amount of torque 
producing current available to 
stop the motor when the 
Stopping Mode is set to 
Current Decel. If this attribute 
is not supported, the drive 
device shall use the configured 
Positive and Negative Peak 
Current Limits. 
612 Stopping Time When disabling or aborting an Sec 


Limit axis, this parameter determines 
the maximum amount of time 
Stopping Current can be 
applied to bring the motor to a 


successful stop before the axis 
is disabled and all current is 
removed from the motor. 
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Attr ID) Need in Implem Access | NV | Attribute Name Data Description of Semantics of Values 
Rule Type Attribute 


613 Optional — PVT Set Resistive Brake When an external resistive Sec 
(PM Motors Contact Delay brake is used, the Resistive 
Only) Brake Contact Delay can be 
set to delay the enabling of 
the drive power structure 
until after the resistive brake 
has had time to connect the 
motor to the drive. 
See Semantics for details. 


614 Optional - PVT Set Mechanical This attribute allows direct Enumeration: 
Brake Control control of the drive output 0 = Brake Release 
connected to the mechanical 1 = Brake Engage 
brake mechanism. When set to 
release or engage the brake, the 
brake is released or engaged 
without regard to the current 
state of the axis. An axis state 
transition however can override 
the Mechanical Brake Control 
setting. For example, if this 
attribute is a 0 and the brake is 
released and then the axis 
transitions the Stopped state to 
the Running state and back to 
the Stopped state, the brake 
automatically engages as part 
of the transition to the stopped 
state. The device indicates this 
condition by changing the 
Mechanical Brake Control 
setting to 1, indicating that the 
brake is engaged. 
615 Required - PVT Set Mechanical When enabling the axis, the | Sec 
Brake Release Mechanical Brake Release 
Delay Delay value determines the 
amount of time the drive 
shall delay transition from 
the Starting state to the 
Running or Testing states. 
This delay prevents any 
commanded motion of the 
motion axis until the 
external mechanical brake 
has had enough time to 
disengage. 
See Semantics for details. 
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Attr ID} NeedinImplem | Access | NV | Attribute Name Data Description of Semantics of Values 
Rule Type Attribute 


616 | Required-PVT | Set Mechanical When disabling the axis, the | Sec 
Brake Engage Mechanical Brake Engage 
Delay Delay value determines the 

amount of time the inverter 
power structure shall remain 
enabled after the axis has 
decelerated to standstill. 
This allows time for an 
external mechanical brake to 
engage. The configured 
Stopping Mode determines 
the type of stopping 
sequence applied 

.See Semantics for details. 


5-46.14.1 Semantics 
5-46.14.2 Attribute #610 — Stopping Mode 


When disabling or aborting an axis, this attribute determines the stopping method to apply to 
the motor. The final state after the stopping method is applied is the Stopped state. In the 
Stopped state the axis’ inverter power structure should either be Disabled (Disable selection) 
and free of torque or actively held (Hold selection) in a static condition via servo action. This 
attribute has no impact or relationship to the planner generated acceleration and deceleration 
profiles. 


Table 5-46.41 Stopping Mode Enumeration Definitions 


Enum. Req. Name Description 
Opt. 


Disabled & Coast Disable & Coast immediately disables the inverter power structure which 
causes the motor to coast unless some form of external braking is applied. 
This is equivalent to an IEC-60204-1Category 0 Stop. 


1 R/C Current Decel & Current Decel & Disable forces the drive to stop under control of the 
Disable configured Stopping Current. This is accomplished by forcing the relevant 
upstream control loops to saturate by setting the appropriate command 


references to fixed values. In the position mode, the position command is 
reset to actual position when the axis reaches zero velocity. Once stopped, 
or the configured Stopping Time limit expires, the device disables the 
power structure and control loops. This stop mode complies with the IEC- 
60204-1 Category 1 Stop. 


Ramped Decel & Ramped Decel & Disable applies only to the velocity control mode. This 
Disable stop mode immediately zeroes the output of the Velocity Command 
Selector causing the Accel Limiter to ramp the motor speed down to zero. 
Once stopped, or the configured Stopping Time limit expires, the device 
disables the power structure and control loops. This stop mode also 
complies with the IEC-60204-1 Category 1 Stop. 


3 O/C Current Decel & Hold | Current Decel & Hold behaves like Current Decel & Disable, but leaves the 
power structure and control loops active under local command reference 
control with holding torque. In this way there is active holding torque to 
maintain the stopped condition. This stop mode complies with the IEC- 
60204-1 Category 2 Stop. 


— 5-466 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Enum. 


5-127 


128- 
255 


5-46.14.3 


5-46.14.4 
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Description 


Ramped Decel & Hold | Ramped Decel & Hold behaves like Ramped Decel & Disable, but leaves 
the power structure and control loops active under local command reference 
control. In this way there is active holding torque to maintain the stopped 
condition. This stop mode also complies with the IEC-60204-1 Category 2 
Stop. 


[Resend 


i oil Vendor Specific 


Attribute #613 — Resistive Brake Contact Delay 


When an external resistive brake is used, an external contactor switches the UVW motor leads 
from the inverter power structure to an energy dissipating resistor to stop the motor. This 
switching does not occur instantaneously and so enabling the power structure too early can 
cause electrical arcing across the contactor. To prevent this condition, the Resistive Brake 
Contact Delay can be set to the maximum time that it takes to fully close the contactor across 
the UVW motor lines so when the axis is enabled, the inverter power structure is not enabled 
until after the Resistive Brake Contact Delay Time has expired. Resistive Brake operation is 
only applicable to PM Motor types. The following sequence illustrates how the Resistive Brake 
Contact Delay factors into the overall Enable Sequence that may also include the operation of a 
Mechanical Brake. 


Drive Enable Sequence: 
Switch to Starting state. 
Activate Resistive Brake contactor to connect motor to drive. 


Wait for “Resistive Brake Contact Delay” while Resistive Brake contacts close. 


1 

2 

S) 

4. Enable drive power structure. 

5. Activate Mechanical Brake output to release brake. 

6. Wait for “Mechanical Brake Release Delay” while brake releases. 
7. Transition to Running state. 

Attribute #615 — Mechanical Brake Release Delay 


When enabling the axis, the Mechanical Brake Release Delay value determines the amount of 
time the axis shall delay transition from the Starting state to the Running or Testing states. This 
delay prevents any commanded motion of the axis until the external mechanical brake has had 
enough time to disengage. 


Drive Enable Sequence: 

Switch to Starting state. 

Activate Resistive Brake contactor to connect motor to drive. 

Wait for “Resistive Brake Contact Delay” while Resistive Brake contacts close. 
Enable drive power structure. 

Activate Mechanical Brake output to release brake. 


Wait for “Mechanical Brake Release Delay” while brake releases. 


Nag F WN bP 


Transition to Running (or Testing) state. 
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5-46.14.5 Attribute #616 — Mechanical Brake Engage Delay 


When disabling the axis, the Mechanical Brake Engage Delay value determines the amount of 
time the inverter power structure shall remain enabled after the axis has decelerated to 
standstill. This allows time for an external mechanical brake to engage. The configured 
Stopping Mode determines the type of stopping sequence applied. 


Drive Disable Sequence (Category 0 Stop): 

1. Disable drive power structure. 

2. Transition to Stopped state. 

3. Deactivate Mechanical Brake output to engage brake. 

4. Deactivate Resistive Brake contactor to disconnect motor from inverter power structure. 
Drive Disable Sequence (Category 1 Stop): 

Switch to Stopping state. 

Apply “Current Decel” or “Ramp Decel” method to stop motor. 

Wait for zero speed or “Stopping Time Limit”, whichever occurs first. 
Deactivate Mechanical Brake output to engage brake. 

Wait for “Mechanical Brake Engage Delay” while brake engages. 
Disable inverter power structure. 


Transition to Stopped state. 


OD: Oa OP ee Go oR 


Deactivate Resistive Brake contactor to disconnect motor from inverter power structure. 
Drive Disable Sequence (Category 2 Stop): The mechanical brake not used. 
5-46.15 DC Bus Control Attributes 


The following table contains Motion Axis Object instance attributes associated with DC Bus 
control including functionality to address both under-voltage and over-voltage conditions. 


Table 5-46.42 DC Bus Control Attributes 
Attr Need in Access | N Attribute Name Data Description of Semantics of 
ID Implem Rule Vv Type Attribute Values 
620 ede DC Bus Voltage REAL _ | Measured DC Bus Voltage. Volts 
PVT 


621 Required - | Get DC Bus Voltage - REAL Normal DC Bus Voltage during | Volts 
PVT Nominal operation as determined by 

averaging the DC Bus Voltage 
over a drive specific time 
interval. This value is used as 
the basis for Bus Overvoltage 
and Undervoltage limits. 
NOTE: If the drive does not 
support this bus voltage 
averaging concept, the 
alternative is to hard code this 
value. 
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Attr 
ID 


624 


625 


627 


628 


629 


Need in Access | N Attribute Name Data Description of 
Implem Rule Vv Type Attribute 


Required - 
PVT 


Optional - 
PVT 


Optional - 
PVT 


Optional — 
PVT 


Optional - 
PVT 


Motion Axis Object, Class Code: 42hex 


Bus Regulator Action 


Bus Regulator Power 
Limit 


Power Loss Action 


Power Loss 
Threshold 


Drive Shutdown 
Action 
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Controls the method of 
operation of the DC Bus 
Regulator that addresses the 
regenerative over-voltage 
conditions that can occur when 
decelerating a motor. 


If Disabled, no regulation is 
applied to the DC Bus level to 
control regenerative energy 
sourced by the motor. 


When Shunt Regulator is 
selected the associated shunt 
regulation hardware is applied 
to the DC Bus to dissipate 
regenerative energy via a 
resistor. 


Limits the amount of power 
allowed to transfer between the 
motor and the DC Bus during 
regenerative braking of the 
motor load. When using an 
external shunt resistor, set this 
value to its maximum value. 


Set the reaction to a DC Bus 
under-voltage condition when 
the DC Bus drops below a 
hard-coded threshold in the 
drive or the configured Power 
Loss Threshold 


Sets the Level for Power Loss 
as percent of nominal DC Bus 
Voltage. If this value is 0, the 
hard-coded threshold is used. 


Selects the drive's action when 
transitioning to the Shutdown 
state. Standard action is to 
immediately disable the drive’s 
power structure. Alternatively, 
action can be taken to drop the 
DC Bus voltage as well. 


ODVA & ControlNet International, Ltd. 


Semantics of 
Values 


Enumeration: 

0 = Disabled 
(R/PVT) 

1 = Shunt 
Regulator (R/PVT) 
2-127 = reserved 
128-255 = vendor 
specific 


% Regulator Rated 


Enumeration: 

0 = Disabled & 
Coast 

1 = Decel 

2 = Continue 
3-127 = reserved 
128-255 = vendor 
specific 


Enumeration: 

0 = Disable (R) 

1 = Drop DC Bus 
(O) 

2-127 = reserved 

128-255 = vendor 
specific 
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5-46.16 Power and Thermal Management Attributes 


The following attribute tables contain all power and thermal related attributes associated with a 


Motion Axis Object instance. 


Table 5-46.43 Power and Thermal Management Status Attributes 


Attr ID} Need in Access | N | Attribute Name Data Description of Attribute 
Implem Rule Vv Type 


Motor Capacity 


635 Required - | Get 
PVT 


Temperature 


636 Required - | Get Inverter Capacity 
PVT 

637 Optional - | Get Converter 
PVT Capacity 

638 Optional - | Get Bus Regulator 
PVT Capacity 

639 Optional - | Get Drive Ambient 
PVT Temperature 

I 


640 Optional- | G 
PVT 


Inverter Heatsink 


Real-time estimate of the 
continuous rated motor thermal 
capacity utilized during 
operation based on the motor 
thermal model. A value of 
100% would indicate that the 
motor is being used at 100% of 
rated capacity as determined by 
the continuous current rating of 
the motor. 


Real-time estimate of the 
continuous rated inverter 
thermal capacity utilized during 
operation based on the inverter 
thermal model. A value of 
100% would indicate that the 
inverter is being used at 100% 
of rated capacity as determined 
by the continuous current rating 
of the inverter. 


Real-time estimate of the 
continuous rated converter 
thermal capacity utilized during 
operation based on the 
converter thermal model. A 
value of 100% would indicate 
that the converter is being used 
at 100% of rated capacity as 
determined by the continuous 
current rating of the converter. 


Real-time estimate of the 
continuous rated bus regulator 
thermal capacity utilized during 
operation based on the bus 
regulator thermal model. A 
value of 100% would indicate 
that the bus regulator is being 
used at 100% of rated capacity 
as determined by the 
continuous current rating of the 
bus regulator. 


Current internal ambient 
temperature of the device 
enclosure. 


Current temperature of the 
drive inverter heatsink, 
typically based on an embedded 
temp sensor. 


Semantics of Values 


% Motor Rated 


% Inverter Rated 


% Converter Rated 


% Regulator Rated 


Degrees C 


Degrees C 
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Attr ID} Need in Access | N | Attribute Name Data Description of Attribute Semantics of Values 
Implem Rule Vv Type 


641 Optional - | Get Inverter Current temperature of the Degrees C 
PVT Temperature power block used in the 
inverter’s power structure, 
sometime referred to as the 
semiconductor junction 
temperature. 


642 Optional - | Get Motor Current temperature of the Degrees C 
PVT Temperature motor stator, typically based on 
an embedded temp sensor. 
643 Optional - | Get Feedback 1 REAL Current temperature of the Degrees C 
PVT Temperature Feedback 1 device. 
644 Optional - | Get Feedback 2 REAL Current temperature of the Degrees C 
PVT Temperature Feedback 2 device. 


645 Optional — | Get Inverter Overload Factory set maximum limit for % Inverter Rated 
PVT Limit Inverter Capacity that when 
exceeded triggers the selected 
Inverter Overload action. 


Table 5-46.44 Power and Thermal Management Configuration Attributes 


Attr Need in Access | N | Attribute Name Data Description of Attribute Semantics of Values 
ID Implem Rule Vv Type 


646 | Optional- | Set Motor Overload Selects the device's response | Enumeration: 
PVT Action to a motor overload 0 = None (R) 
condition based on an I’t 1 = Current Foldback 
based motor thermal model. | ©) 
The motor overload 2-127 = reserved 
ws 128-255 = vendor 
condition occurs when the on 
specific 
motor thermal model 
indicates that the Motor 
Capacity has exceeded the 
Motor Overload Limit. This 
motor overload action 
functionality is independent 
of the motor overload 
exception action 
functionality. 
No explicit action is taken by 
the device in the overload 
condition if None is the 
selected overload action. 
Selecting the Current Foldback 
action, however, results in a 
reduction of the current 
command via the Motor 
Thermal Current Limit attribute 
value that is reduced in 
proportion to the percentage 
difference between Motor 
Capacity and the Motor 
Overload Limit. 
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Attr Need in Access | N | Attribute Name Data Description of Attribute Semantics of Values 
ID Implem Rule Vv Type 


647 | Optional- | Set Inverter Overload Selects the device's response | Enumeration: 
PVT Action to an inverter overload 0 = None (R) 
alarm condition based on an | 1 = Current Foldback 
I’t based inverter thermal (0) 
model. The inverter 2-127 = reserved 
ot 128-255 = vendor 
overload alarm condition es 
i specific 
occurs when the inverter 
thermal model indicates that 
the Inverter Capacity has 
exceeded the Inverter 
Overload Limit. The 
Inverter Overload Action 
provides opportunities to 
mitigate the overload 
condition without stopping 
operation. This inverter 
overload action 
functionality is independent 
of the motor overload 
exception action 
functionality. 
No explicit action is taken by 
the device in the overload 
condition if None is the 
selected overload action. 
Selecting the Current Foldback 
action, however, results in a 
reduction of the current 
command via the Inverter 
Thermal Current Limit attribute 
value that is reduced in 
proportion to the percentage 
difference between Inverter 
Capacity and the Inverter 
Overload Limit 


5-46.17 Axis Status Attributes 


The following attributes tables contain all status attributes associated with a Motion Axis 
Object instance. 


Table 5-46.45 Axis Status Attributes 


Attr Need in Access = Attribute Name Data Description of Attribute Semantics of Values 
ID Implem Rule Type 


650 | Required - Axis State USINT Enumerated value indicating Enumeration: 
All the state of the axis. 0 = Initializing 

1 = Pre-Charge 
2 = Stopped 
3 = Starting 
4 = Running 
5 = Testing 
6 = Stopping 
7 = Aborting 
8 = Major Faulted 
9 = Start Inhibited 
10 = Shutdown 
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Attr Need in Access Attribute Name rae Description of Attribute Semantics of Values 
ID 7 — 
11-255: Reserved 
651 —— - — Status — Sara of bits indicating the | See Semantics 
All internal status of the motion 
axis. 
652 | Required - Axis Status - Mfg | DWORD | Collection of bits indicating the | Bitmap: 
All status of the axis. 0-31: Vendor 
Specific 
(Published in Product 
Manual) 
653 The Axis I/O Status attribute is | See Semantics 


Required - 
All 


: Axis I/O Status 


a 32-bit collection of bits 
indicating the state of standard 
digital inputs and outputs 
associated with the operation of 
this axis. A value of zero for a 
given input bit indicates a 
logical 0 value, while a value 
of 1 indicates a logical 1 value 


654 | Required - Get Axis I/O Status - DWORD | Collection of bits indicating the | Bitmap: 

All Mfg state of vendor specific digital 0-31: Vendor 
inputs associated with the Specific 
operation of this axis. A value (Published in Product 
of zero for a given input bit Manual) 
indicates a logical 0 value, 
while a value of 1 indicates a 
logical 1 value. 

94 Required— | Set* Status Data Set BYTE Bit mapped field that See Semantics 

All determines what status data 
values are to be transmitted to 
the controller via the Device- 
to-Controller Connection. 


5-46.17.1 Semantics 
5-46.17.2 Attribute #651 — Axis Status 

The Axis Status attribute is a 32-bit collection of bits indicating various internal status 
conditions of the motion axis. 


Table 5-46.46 Axis Status Bit Definitions 


Name Description 


Local Control This bit is set if axis is taking command reference and services from 
local interface instead of via the remote interface (e.g.: the CIP Motion 


controller). 


Alarm This bit is set if the axis has detected one or more exception conditions 
configured to generate an alarm. 


DC Bus Up This bit is set if DC Bus has charged up to an operational voltage level. 
Power Structure This bit is set if the axis amplifier is energized and capable of 

Enabled generating motor flux and torque. 

Motor Flux Up This bit is set if motor flux for an induction motor has reached an 


operational level. 


Tracking Command This bit is set if the axis control structure is now actively tracking the 
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Bit | Rec. Name Description 
Opt. 
command reference from motion planner 
6 R/P | Position Lock This bit is set if the actual position is within Position Lock Tolerance of 
command position. 
7 R/V | Velocity Lock This bit is set if the actual velocity is within Velocity Lock Tolerance 
of command velocity. 
8 R Velocity Standstill This bit is set if the actual velocity is within Velocity Standstill 
Window of 0. 
9 R Velocity Threshold This bit is set if the absolute actual velocity is below Velocity 
Threshold. 
10 R/V | Velocity Limit This bit is set if the command velocity in velocity control mode is 
currently being limited by the Velocity Limiter. 
11 R/V | Acceleration Limit This bit is set if the rate of change of the command velocity in velocity 
control mode is currently being limited by the Acceleration Limiter. 
12 R/V | Deceleration Limit This bit is set if the rate of change of command acceleration in velocity 
control mode is currently being limited by the Deceleration Limiter. 
13 R/C | Torque Threshold This bit is set if the absolute filtered torque reference is below the 
Torque Threshold. 
14 R/C | Current Limit This bit is set if the command current, Iq, is currently being limited by 
the Current Vector Limiter. 
15 R/C | Thermal Limit This bit is set if Current Limit condition of the axis is being limited by 
any of the axis’s Thermal Models. 
16- Reserved 
31 


5-46.17.3 Attribute #653 — Axis I/O Status 


The Axis I/O Status attribute is a 32-bit collection of bits indicating the state of standard digital 
inputs and outputs associated with the operation of this axis. A value of zero for a given input 
bit indicates a logical 0 value, while a value of 1 indicates a logical 1 value. 


Table 5-46.47 Axis I/O Status Bit Definitions 


Bit Rec. Name Description 
Opt. 
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Bit Rec. Name Description 
Opt. 


15 | O | Feedback 3 ChB 

16 | O | Feedback 4ChA 

17 | O | Feedback 4 ChB 

18 Eom Resistive Brake Output 
19 | oO | Mechanical Brake Output 


5-46.17.4 Attribute #94 — Status Data Set 


5-46.18 


The Status Data Set attribute is an 8-bit collection of bits indicating what Status attributes are to 
be transmitted to the controller over the Device-to-Controller Connection. Status data appears 
in connection data structure in the same order as the bit numbers defined in the table below. For 
example, Axis Fault Status would appear before, Axis Alarm Status data in the Status Data Set 
structure. Multiple attributes comprising a selected Status Data Element are transmitted in the 
order listed from top to bottom, so the Axis Fault Code is transmitted before Mfg Axis Fault 
Code. 


Table 5-46.48 Status Data Set Bit Definitions 


Status Data Element Produced 


0 Initialization Fault Code USINT 
Initialization Fault Code - Mfg USINT 
Axis Fault Code USINT 
Axis Fault Code - Mfg 2 
ie Alarm Code USINT 
Axis Alarm Code - Mfg USINT 
Start Inhibit Code USINT 


Start Inhibit Code - Mfg 
Axis Fault Time Stamp 


Axis Fault Status 
Axis Fault Status - Mfg 


Axis Alarm Status 
Axis Alarm Status - Mfg 


Start Inhibit Status 
Start Inhibit Status - Mfg 


Axis Status 
Axis Status - Mfg 


Axis I/O Status 
Axis I/O Status - Mfg 


Reserved Reserved 


Reserved Reserved 


Vendor Specific Vendor Specific 


Exception, Fault, and Alarm Status Attributes 


The following attribute tables contain all exception, fault, and alarm related attributes 
associated with a Motion Axis Object instance. Exceptions are conditions that can occur during 
motion axis operation that have the potential of generating faults or alarms. 
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Table 5-46.49 Exception, Fault and Alarm Status Attributes 


Attr Need in Access Attribute Name Data Description of 
ID Implem Rule Type Attribute 


655 | Required - Axis Exception 
All Status 

656 | Required - Axis Exception 
All 


Status - Mfg 
657 | Required - 
All 
658 | Required - 
All 


Axis Fault Status 


Axis Fault Status - 


A bit map that represents the 
current state of all standard 
exception conditions. See the Std. 
Exception Table bit map 
definition later in this section for 
detail on the bit locations. Each 
exception has a corresponding 
Exception Action. Exceptions that 
are configured to be Ignored are 
only visible in this attribute. 


A bit map that represents the 
current state of all manufacturer 
specific exception conditions. See 
the Mfg. Exception Table 
published in drive product 
manual. Each exception has a 
corresponding Exception Action. 
Exceptions that are configured to 
be Ignored are only visible in this 
attribute. 


A bit map that represents the state 
of all standard runtime faults. The 
bit map is identical to that of the 
Axis Exception Status attribute. 
Fault status bits when set are 
latched until a fault reset occurs. 
A fault reset clears the runtime 
fault bits, but the bits set again 
immediately if the underlying 
exception condition is still 
present. Any exceptions whose 
Exception Action is configured to 
ignore or report as alarms do not 
appear in this attribute. 


A bit map that represents the state 
of all manufacturer specific 
runtime faults. The bit map is 
identical to that of the Mfg. Axis 
Exception Status attribute. Fault 
status bits when set are latched 
until a fault reset occurs. A fault 
reset clears the runtime fault bits, 
but the bits set again immediately 
if the underlying exception 
condition is still present. Any 
exceptions whose Exception 
Action is configured to ignore or 
report as alarms do not appear in 
this attribute. 


Semantics of 
Values 


See Semantics. 


See Mfg. 
Exception Table 


(Published in 
Product Manual) 


See Semantics 


See Mfg. 
Exception Table 
(Published in 
Product Manual) 
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Attr Need in Access ase Name Data Description of Semantics of 
ID Implem Rule Type Attribute Values 
659 | Required - Axis Ricca Status LWORD | A bit map that represents the See Semantics 
All current state of all standard alarm 
conditions. The bit map is 
identical to that of the Std. Axis 
Exception Status attribute. Only 
exception conditions whose 
Exception Action is configured to 
report as an alarm appear in this 
attribute, and will not be reported 
in the Axis Fault Status attribute. 
Alarm status bits when set are not 
latched and will clear as soon as 
the underlying exception 
condition is corrected. 
Required - Axis Alarm Status - LWORD | A bit map that represents the See Mfg. 
All Mfg current state of all manufacturer Exception 
specific alarm conditions. The bit | Table. 
map is identical to that of the (Published in 
Mfg. Axis Exception Status Product Manual) 
attribute. Only exception 
conditions whose Exception 
Action is configured to report as 
an alarm appear in this attribute, 
and will not be reported in the 
Axis Fault Status attribute. Alarm 
status bits when set are not 
latched and will clear as soon as 
the underlying exception 
condition is corrected. 


Axis Fault Code USINT An 8-bit enumeration that See Semantics 
specifies the standard exception 
that led to the current faulted 
state. The value corresponds to 
the bit position of the exception 
condition, and a value of 0 
indicates that no standard runtime 
faults currently exist. This 
attribute only reports the first 
runtime fault that transitioned the 
axis from an unfaulted state to the 
faulted state, and then only if that 
was not a Mfg. Axis Fault. 
Subsequent runtime faults that 
occur when the Axis Fault Code 
attribute or the Mfg. Axis Fault 
Code attribute is already nonzero 
are not reported in this attribute. 
Note that no runtime faults exist if 
both the Axis Fault Code and the 
Mfg. Axis Fault Code are zero. 
The Axis Fault Code and the Mfg. 
Axis Fault Code can never both 
be non-zero at the same time. 
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Attr Need in Access 2 Attribute Name Data Description of Semantics of 
ID Implem Rule Type Attribute Values 


662 | Required - Axis Fault Code - An 8-bit enumeration that See Mfg. 

All Mfg specifies the manufacturer Exception Table 
specific exception that led to the (Published in 
current faulted state. The value Product Manual) 
corresponds to the bit position of 
the exception condition, and a 
value of 0 indicates that no 
manufacturer runtime faults 
currently exist. This attribute only 
reports the first runtime fault that 
transitioned the axis from an 
unfaulted state to the faulted state, 
and then only if that was a Mfg. 

Axis Fault. Subsequent runtime 
faults that occur when either the 
Axis Fault Code attribute or the 
Mfg. Axis Fault Code attribute is 
already nonzero are not reported 
in this attribute. Note that no 
runtime faults exist if both the 
Axis Fault Code and the Mfg. 
Axis Fault Code are zero. The 
Axis Fault Code and the Mfg. 
Axis Fault Code can never both 
be non-zero at the same time. 


663 | Required - Get Axis Fault Time A 64-bit Time Stamps of the Nanoseconds 
All exception that led to the current 
non-zero Axis Fault Code or Mfg 
Axis Fault Code. The time stamp 
format is absolute follows the CIP 
Sync standard with 0 
corresponding to January 1, 1970. 


664 | Required - Get Axis Alarm Code An 8-bit enumeration that See Semantics 

All specifies the exception that led to 
the current standard alarm 
condition. The value corresponds 
to the bit position of the exception 
condition that led to the alarm, 
and a value of 0 indicates that no 
standard alarms currently are 
active. If the standard alarm 
condition is removed, this 
attribute will automatically be 
cleared or else be set to another 
standard alarm condition if one is 
present. If multiple standard 
alarm conditions are present, the 
Axis Alarm Code is set to the 
lowest active alarm bit number. 
The Axis Alarm Code and the 
Mfg. Axis Alarm Code can both 
be non-zero at the same time. 
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Attr Need in Access | N Attribute Name Data Description of Semantics of 
ID Implem Rule Vv Type Attribute Values 


665 | Required - Get Axis Alarm Code - An 8-bit enumeration that See Mfg. 
All Mfg specifies the manufacturer Exception Table 
specific exception that led to the (Published in 
current alarm condition. The Product Manual) 
value corresponds to the bit 
position of the manufacturer 
exception condition that led to the 
alarm, and a value of 0 indicates 
that no manufacturer alarms 
currently exist. If the 
manufacturer alarm condition is 
removed, this attribute will 
automatically be cleared or else 
set to another manufacturer alarm 
condition if one is present. If 
multiple manufacturer alarm 
conditions are present, the Mfg. 
Axis Alarm Code is set to the 
lowest active alarm bit number. 
The Axis Alarm Code and the 
Mfg. Axis Alarm Code can both 
be non-zero at the same time. 
666 | Optional - Get Fault Sub Code USINT A 16-bit enumeration that Enumeration 

specifies the fault sub code for the | specific to fault 

fault condition currently condition. 

displayed on the front panel of the 

device (and reported in the Axis 

Fault Code). This attribute allows 

additional detail to be provided in 

the case of some faults, and has a 

different interpretation for each 

fault. Non-zero values indicate 

that additional detail is present. 
5-46.18.1 Semantics 


All 
5-46.18.2 Standard Exception Table 


The following table defines a list of standard exceptions associated with the Axis Exception 
Status attributes but also applicable to Axis Fault Status, Axis Fault Code, Axis Alarm Status, 
and Axis Alarm Code attributes. 


Table 5-46.50 Standard Exception Table 


0 Reserved This bit cannot be used since the Alarm Codes and Fault Code are defined 
by the associated exception bit number and an Alarm Code or Fault Code of 
0 means no alarm or fault condition is present. 


1 Motor Stall Induction motor stall condition detected. 


Motor Commutation Permanent magnet motor commutation problem detected. Example would 
be an illegal state “111” or “000” for Hall Sensor. 


2 

4 Motor Overspeed FL Motor speed has exceeded its maximum limit given by either Rotary Motor 
Max Speed or Linear Motor Max Speed attributes depending on the type of 
motor. 
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Exception 
Motor Overspeed UL 


Motor Overtemperature FL 


Motor Overtemperature UL 


Motor Thermal Overload FL 


Motor Thermal Overload UL 


Reserved 
Reserved 


Inverter Overcurrent 


Inverter Overtemperature FL 


Inverter Overtemperature UL 


Inverter Thermal Overload FL 


Inverter Thermal Overload UL 


Reserved 
Reserved 


Converter Overtemperature FL 


Converter Overtemperature 
UL 


Converter Thermal Overload 
FL 


Converter Thermal Overload 
UL 


Converter AC Phase Loss 
Converter AC Ground Current 
Reserved 

Reserved 


Bus Regulator 
Overtemperature FL 


Bus Regulator 
Overtemperature UL 


Bus Regulator Thermal 
Overload FL 


Bus Regulator Thermal 
Overload UL 


Bus Undervoltage FL 


Bus Undervoltage UL 


Description 


Motor speed has exceeded the user defined Motor Overspeed User Limit 
margin above the Positive Velocity Limit or below the Negative Velocity 
Limit. 

Motor temperature has exceeded its factory set temperature limit given by 
Motor Overtemperature Factory Limit, or the integral motor thermal switch 
has tripped. 


Motor temperature has exceeded the user defined temperature limit given by 
Motor Overtemperature User Limit. 


Motor thermal model has exceeded its factory set thermal capacity limit 
given by Motor Thermal Overload Factory Limit. 


Motor thermal model has exceeded its user defined thermal capacity given 
by Motor Thermal Overload User Limit. 


Inverter current has exceeded the factory set peak or instantaneous current 
limit. 

Inverter temperature has exceeded its factory set temperature limit given by 
Inverter Overtemperature Factory Limit. 


Inverter temperature has exceeded the user defined temperature limit given 
by Inverter Overtemperature User Limit. 


Inverter thermal model has exceeded its factory set thermal capacity limit 
given by Inverter Thermal Overload Factory Limit. 


Inverter thermal model has exceeded its user defined thermal capacity given 
by Inverter Thermal Overload User Limit. 


Converter temperature has exceeded its factory set temperature limit given 
by Converter Overtemperature Factory Limit. 


Converter temperature has exceeded the user defined temperature limit 
given by Converter Overtemperature User Limit. 


Converter thermal model has exceeded its factory set thermal capacity limit 
given by Converter Thermal Overload Factory Limit. 


Converter thermal model has exceeded its user defined thermal capacity 
given by Converter Thermal Overload User Limit. 


One or more phases have been lost on the AC line to the converter. 


Excessive Ground Current was detected by the converter. 


Bus Regulator temperature has exceeded its factory set temperature limit 
given by Bus Regulator Overtemperature Factory Limit. 


Bus Regulator temperature has exceeded the user defined temperature limit 
given by Bus Regulator Overtemperature User Limit. 


Bus Regulator thermal model has exceeded its factory set thermal capacity 
limit given by Bus Regulator Thermal Overload Factory Limit. 


Bus Regulator thermal model has exceeded its user defined thermal capacity 
given by Bus Regulator Thermal Overload User Limit. 


DC Bus voltage level is below the factory set limit given by Bus 
Undervoltage Factory Limit. 


DC Bus voltage level is below user defined limit given by Bus Undervoltage 
User Limit. 
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Bus Overvoltage FL 
Bus Overvoltage UL 


Feedback 1 Signal Noise 
Feedback 1 Signal Loss 


Feedback 1 Serial 
Communication 


Feedback 1 Power 


Feedback 2 Signal Noise 


Feedback 2 Signal Loss 


Feedback 2 Serial 
Communication 


Feedback 2 Power 


Hardware Overtravel Positive 
Hardware Overtravel Negative 


Illegal Mode Change 


Description 


DC Bus voltage level is above the factory set limit given by Bus 
Overvoltage Factory Limit. 


DC Bus voltage level is above user defined limit given by Bus Overvoltage 
User Limit. 


Noise induced A/B channel state changes were detected on the Feedback 1 
signal connection. Specifically, the rate at which these noise events have 
occurred has exceeded a factory set rate limit. 


One or more A/B channel Feedback 1 device signal connections are open, 
shorted, missing, or severely attenuated. Specifically, the detected voltage 
levels of the signals are below a factory set limit. 


The number of consecutive missed or corrupted serial data packets over the 
serial data channel associated with Feedback 1 has exceeded a factory set 
limit. 

A problem has been found related to the power supply, or battery, associated 
with the Feedback 1 device. 


Noise induced A/B channel state changes were detected on the Feedback 2 
signal connection. Specifically, the rate at which these noise events have 
occurred has exceeded a factory set rate limit. 


One or more A/B channel Feedback 2 device signal connections are open, 
shorted, missing, or severely attenuated. Specifically, the detected voltage 
levels of the signals are below a factory set limit. 


The number of consecutive missed or corrupted serial data packets over the 
serial data channel associated with Feedback 2 has exceeded a factory set 
limit. 

A problem has been found related to the power supply, or battery, associated 
with the Feedback 2 device. 


Axis moved beyond the physical travel limits in the positive direction and 
activated the Positive Overtravel limit switch. 


Axis moved beyond the physical travel limits in the negative direction and 
activated the Negative Overtravel limit switch. 


The Position Error value of the position control loop has exceeded the 
configured value for Position Error Tolerance. 


The Velocity Error value of the velocity control loop has exceeded the 
configured value for Velocity Error Tolerance. 


Motor torque has risen above user defined maximum torque level given by 
Overtorque Limit. 


Motor torque has dropped below user defined minimum torque level given 
by Undertorque Limit. 


Controller has specified an unsupported Control Mode or Feedback 
Configuration 


— 5-481 -— 
Edition 3.3 


ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 6 


Motion Axis Object, Class Code: 42hex 


Bit Exception Description 
61 Enable Input Deactivated Enable has been deactivated while the axis is in Running state. 


62 Controller Initiated Exception | Exception generated specifically by controller. 


63 | External Exception Input Exception generated by external input to device. 


5-46.19 Exception Limit Attributes 


The following attribute tables contain all exception limit related attributes associated with a 
Motion Axis Object instance. Exception Limit attributes define the conditions under which a 
corresponding exception is generated during motion axis operation that has the potential of 
generating either a fault or alarm. They are typically associated with temperature, current, and 
voltage conditions of the device that are continuous in nature. Factory Limits (FL) for 
exceptions are usually hard coded in the device and typically result in a major fault condition. 
User Limits (UL) for exceptions are configurable and typically used to generate a minor fault, 
or alarm condition. For this reason, the User Limits are generally set inside the corresponding 
Factory Limits. Note that the triggering of a User Limit exception does not preclude triggering 
of the corresponding Factory Limit exception; the two exception trigger conditions are totally 
independent of one another. 


Table 5-46.51 Exception Factory Limit Info Attributes 


Attr Need in Access | N Attribute Name Data Description of Semantics of Values 
ID Implem Rule Vv Type Attribute 


680 | Optional - Motor Returns the Factory Limit for 
PVT Overtemperature the Motor Overtemperature 
Factory Limit FL exception based on a 
factory set value related to the 
Motor Max Winding 
Temperature of the motor. 


681 | Optional - Get Motor Thermal Returns the Factory Limit for | % Motor Rated 
PVT Overload Factory the Motor Thermal Overload 
Limit FL exception based on a 
factory set value related to the 
Motor Thermal Overload 
rating of the motor. 
682 | Optional - Get Inverter Returns the Factory Limit for 
PVT Overtemperature the Inverter Overtemperature 
Factory Limit FL exception. 
683 | Optional - Get Inverter Thermal Returns the Factory Limit for | % Inverter Rated 
PVT Overload Factory the Inverter Thermal Overload 
Limit FL exception. 
684 | Optional - Get Converter Returns the Factory Limit for 
PVT Overtemperature the Converter 
Factory Limit Overtemperature FL 
exception. 
685 | Optional - Get Converter Thermal Returns the Factory Limit for | % Converter Rated 
PVT Overload Factory the Converter Thermal 
Limit Overload FL exception. 
686 | Optional - Get Bus Regulator Returns the Factory Limit for 
PVT Overtemperature the Bus Regulator 
Factory Limit Overtemperature FL 
exception. 
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Bus Regulator 
Thermal Overload 
Factory Limit 


Bus Overvoltage 
Factory Limit 


Bus Undervoltage 
Factory Limit 


Semantics of Values 


Returns the Factory Limit for 
the Bus Regulator Thermal 
Overload FL exception. 


% Regulator Rated 


Returns the Factory Limit for | Volts 
the Bus Overvoltage FL 


exception. 


Returns the Factory Limit for | Volts 
the Bus Undervoltage FL 


exception. 


Table 5-46.52 Exception User Limit Configuration Attributes 


AttrI Need in Access 
D Implem Rule 
6' t 


Optional - 


Optional - 


Optional - 


Optional - 


ro ro ro ro 
4 4 4 4 


Optional - 


Optional - 


Optional - 


ro ro ro 
Li 
= 4 4 


Optional - 


Optional - 


Optional - 


rg ro ro 
| A 
4 4 4 


Se 


Set 


Set 


Set 


Set 


Set 


Set 


Set 


Set 


Get 


Data 
Type 
REAL 


Vv 


Motor Overspeed 
User Limit 


Motor REAL 
Overtemperature 


User Limit 


Motor Thermal REAL 


Overload User Limit 


Inverter REAL 
Overtemperature 


User Limit 


Inverter Thermal REAL 


Overload User Limit 


Converter REAL 
Overtemperature 


User Limit 


Converter Thermal REAL 


Overload User Limit 


Bus Regulator REAL 
Overtemperature 


User Limit 
REAL 


Bus Regulator 
Thermal Overload 
User Limit 


Bus Overvoltage REAL 


User Limit 
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Attribute 


Sets an incremental speed 
above the Positive Velocity 
Limit and below the Negative 
Velocity Limit that is 
allowable before throwing a 
Motor Overspeed UL 
exception. 


Velocity Control 
Units/Sec 


Sets User Limit for the Motor 
Overtemperature UL 
exception. 


Sets User Limit for the Motor % Motor Rated 
Thermal Overload UL 


exception. 


Sets User Limit for the 
Inverter Overtemperature UL 
exception. 


Sets User Limit for the 
Inverter Thermal Overload UL 
exception. 


Sets User Limit for the 
Converter Overtemperature 
UL exception. 


Sets User Limit for the 
Converter Thermal Overload 


GC 


% Inverter Rated 


°C 


% Converter Rated 


UL exception. 

Sets User Limit for the Bus "C 

Regulator Overtemperature 

UL exception. 

Sets User Limit for the Bus % Regulator Rated 


Regulator Thermal UL 
exception. 


% Nominal Bus 
Voltage 


Sets User Limit for the Bus 
Overvoltage UL exception. 
Unlike the corresponding 
Factory Limit, which is 
specified in Volts, the User 
Limit is based on percent of 
Nominal Bus Voltage during 
operation. 
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AttrI Need in Access Attribute Name Data Description of Semantics of Values 
D Implem Rule Type Attribute 


705 | Optional - Bus Undervoltage Sets User Limit for the Bus % Nominal Bus 
PVT User Limit Undervoltage UL exception. Voltage 
Unlike the corresponding 
Factory Limit, which is 
specified in Volts, the User 
Limit is based on percent of 
Nominal Bus Voltage during 
operation. 


5-46.20 Exception Action Configuration Attribute 


The following configuration attribute controls the action performed by the axis object as a 
result of an exception condition. A unique exception action is defined for each supported 
exception condition. 


Table 5-46.53 Exception Action Configuration Attribute 


Attr Need in Access Attribute Name Description of Semantics of Values 
ID Implem Rule Attribute 


667 | Required - Set Exception Action The Exception Action Enumeration: 
All attribute is 64-element array | 0 = Ignore (O) 
668 | Required - Set 
All 


of enumerated bytes that 1 = Alarm (O) 
5-46.20.1 Semantics 


specifies the action for the 2 = Minor Fault (O) 
5-46.20.2 Attribute #667-668 — Exception Action 


associated standard 3 = Major Fault (R) 

exception. 4-255 = reserved 
See Semantics for details. 

The Exception Action and Exception Action — Mfg. attributes are 64-element array of 

enumerated bytes that specifies the action for the associated standard or manufacturer specific 

exception, respectively. For a given exception, certain actions may not be supported. Each CIP 

Motion product must specify the available actions for each exception that is supported. 


Table 5-46.54 Drive Status Bit Definitions 


Exception Action - The Exception Action Enumeration: 

Mfg attribute is 64-element array | 0 = Ignore (O) 
of enumerated bytes that 1 = Alarm (O) 
specifies the action for the 2 = Minor Fault (O) 
associated manufacturer 3 = Major Fault (R) 
specific exception. 4-255 = reserved 
See Semantics for details 


Description 


Ignore instructs the axis object to completely ignore the exception condition. 
For some exceptions that are fundamental to the operation of the device, it may 
not be possible to Ignore the condition. 


Alarm action simply sets the associated bit in the Alarm Status word but does 
not otherwise affect axis behavior. For some exceptions that are fundamental to 
the operation of the axis, it may not be possible to simply indicate the condition 
as an Alarm. 
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Enum. Name Description 


2 Minor Fault Minor Fault action reports the exception by setting the associated bit in the 
Fault Status word but does not affect axis behavior. Minor Faults allow the 
controller to take application specific action in response to the exception 
condition. For some exceptions that are fundamental to the operation of the 
axis, it may not be possible to simply indicate the condition as a Minor Fault. 


3 Major Fault Major Fault action results in both setting the associated bit in the Fault Status 
word and bringing the axis to a stop based on the factory set “best” available 
stopping method. This “best” stopping method includes both the method of 
decelerating the motor to a stop and the final state of the axis given the 
expected level of control still available. The level of control available depends 
on the specific exception condition and on the configured control mode. 

The available deceleration methods are defined by the Stopping Mode attribute. 
Standard stopping modes, listed in decreasing levels of deceleration control, are 
as follows: 

1. Ramp Decel 

2. Current Decel 

3. Coast 
In general, the “best” stopping mode is the most controlled deceleration method 
still available given the exception condition. 
The final state of the axis in response to the Major Fault exception action can 
be any one of the following states that are listed in decreasing levels of control 
functionality: 

1. Hold (Stopped with Holding Torque) 

2. Disable (Power Structure Disabled) 

3. Shutdown (DC Bus Power Disabled) 
The “best” final state of the axis is the state with the most control functionality 
still available given the exception condition. 
If the application requires exception action that is a more severe stopping 
action than the factory set “best” method, the controller can initiate that action 
programmatically. 
If the application requires exception action that is less severe than the factory 
set “best” method, the controller must configure the axis for a Minor Fault 
exception action and handle the fault directly. This may put device and motor 
components at risk and should only be allowed by the device when there is an 
opportunity, albeit temporal, for the device to remain operational. This is 


important in applications where the value of the product is higher than the 
value of the motor or device. 


4-255 | Reserved 


5-46.21 Initialization Fault Status Attributes 


The following attribute table contains all initialization fault related attributes associated with a 
Motion Axis Object instance. Initialization Faults are conditions that can occur during the 
device initialization process that prevent normal operation of the device. 
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Table 5-46.55 Initialization Fault Status Attributes 


Attr Need in Access [Eeeeeeeceneal Name Data Type Description of Semantics of 
ID Implem Rule Attribute Values 


669 | Required - Escesel Fault DWORD A bit map that represents the See Semantics 
All Status state of all standard 
initialization faults. These 
faults prevent any motion, and 
do not have configurable fault 
actions. Examples of 
initialization faults are 
corrupted memory data, 
calibration errors, firmware 
startup problems, or an invalid 
configuration attribute value. 
Initialization faults cannot be 
cleared with a Fault Reset 
service, although a power-cycle 
provides a new attempt at 
initialization. 
670 | Required - 
All 
671 


Initialization Fault DWORD A bit map that represents the See Mfg. 
Status - Mfg state of all manufacturer Initialization 
specific initialization faults. Fault Table 
These faults prevent any (Published in 
motion, and do not have Product Manual) 
configurable fault actions. 
Examples of initialization 
faults are corrupted memory 
data, calibration errors, 
firmware startup problems, or 
an invalid configuration 
attribute value. Initialization 
faults cannot be cleared with a 
Fault Reset service, although a 
power-cycle provides a new 
attempt at initialization. 


Initialization Fault USINT An 8-bit enumeration that See Semantics 

Code specifies the initialization fault 
that led to the current faulted 
state. The value corresponds to 
the bit position of the standard 
initialization fault condition, 
and a value of 0 indicates that 
no standard initialization faults 
currently exist. This attribute 
only reports the first 
initialization fault that 
transitioned the axis from an 
unfaulted state to a faulted 
state, and then only if that was 
a standard Initialization Fault. 
Note that no initialization faults 
exist if both the Initialization 
Fault Code and the Mfg. 
Initialization Fault Code are 
zero. The Initialization Fault 
Code and the Mfg. 
Initialization Fault Code can 
never both be non-zero at the 
same time. 


— 5-486 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Required - 
All 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 6 


Motion Axis Object, Class Code: 42hex 


Attr Need in Access N Attribute Name Data Type Description of Semantics of 
ID Implem Rule Vv Attribute Values 


672 | Required - Get Initialization Fault An 8-bit enumeration that See Mfg. 
All Code - Mfg specifies the manufacturer Initialization 
specific initialization fault that | Fault Table 
led to the current faulted state. (Published in 
The value corresponds to the Product Manual) 
bit position of the initialization 
fault condition, and a value of 0 
indicates that no manufacturer 
specific initialization faults 
currently exist. This attribute 
only reports the first 
initialization fault that 
transitioned the axis from an 
unfaulted state to a faulted 
state, and then only if that was 
a Mfg. Initialization Fault. Note 
that no initialization faults exist 
if both the Initialization Fault 
Code and the Mfg. 
Initialization Fault Code are 
zero. The Initialization Fault 
Code and the Mfg. 
Initialization Fault Code can 
never both be non-zero at the 
same time. 


5-46.21.1 Semantics 
5-46.21.2 Standard Initialization Fault Table 


The following table defines a list of standard faults associated with the Initialization Fault 
Status attribute and also applicable to the Initialization Fault Code attribute. 


Table 5-46.56 Standard Initialization Fault Table 


Bit Fault Bit Fault 
000 | Reserved 016 Reserved 
001 | Boot Block Checksum Fault 017 | Reserved 
002 | Main Block Checksum Fault 018 Reserved 
003 | Nonvolatile Memory Checksum Fault 019 | Reserved 
004 | Reserved 020 Reserved 
005 | Reserved 021 Reserved 
006 | Reserved 022 Reserved 
007 | Reserved 023 Reserved 
008 | Reserved 024 | Reserved 
009 | Reserved 025 Reserved 
010 | Reserved 026 Reserved 
011 | Reserved 027 Reserved 
012 | Reserved 028 Reserved 
013 | Reserved 029 Reserved 
014 | Reserved 030 Reserved 
015 | Reserved 031 Reserved 
S56 ART 
Edition 3.3 


ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 6 


5-46.22 


Attr ID Need in Access _ Attribute Name Data Description of 
Implem Rule Type Attribute 
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Start Inhibit Status Attributes 


The following attribute table contains all Start Inhibit related attributes associated with a 
Motion Axis Object instance. Start Inhibits are conditions that prevent transition of the motion 
axis from the Stopped State into any of the operational states. 


Table 5-46.57 Start Inhibit Status Attributes 


673 | Required - Start Inhibit Status 
PVT 


674 | Required - 
PVT 


675 Required - 
PVT 


Start Inhibit Status 


A bit map that specifies the 
current state of all standard 
conditions that can inhibit 
starting of the axis: 


A bit map that specifies the 
current state of all 
manufacturer specific 
conditions that can inhibit 
starting of the axis: 


The Start Inhibit Condition 
attribute is an enumeration that 
indicates a condition that 
presently is causing the axis to 
be in the start inhibited state. If 
the inhibiting condition is 
removed, this attribute will 
automatically be cleared or else 
set to another standard 
inhibiting condition if one is 
present. If multiple standard 
start inhibit conditions are 
present, the Start Inhibit Code 
is set to the lowest active start 
inhibit bit number. The Start 
Inhibit Code and the Mfg. Start 
Inhibit Code can both be non- 
zero at the same time. 


Semantics of Values 


See Semantics 


See Mfg. Start Inhibit 
Table 


(Published in Product 
Manual) 


See Semantics 


676 Mfg Start Inhibit The Mfg. Start Inhibit See Mfg. Start Inhibit 
Condition attribute is a Tables 
manufacturer specific (Published in Product 
enumeration that indicates a Manual) 


condition that presently is 
causing the axis to be in the 
start inhibited state. If the 
inhibiting condition is 
removed, this attribute will 
automatically be cleared or else 
set to another manufacturer 
specific inhibiting condition if 
one is present. If multiple 
manufacturer specific start 
inhibit conditions are present, 
the Mfg. Start Inhibit Code is 
set to the lowest active start 
inhibit bit number. The Start 
Inhibit Code and the Mfg. Start 
Inhibit Code can both be non- 
zero at the same time. 


Required - 
PVT 
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5-46.22.1 Semantics 
5-46.22.2 Standard Start Inhibit Table 


The following table defines a list of standard start inhibits associated with the Start Inhibit 
Status attribute and also applicable to the Start Inhibit Status Code attribute. 


Table 5-46.58 Standard Start Inhibit Table 


Bit Start Inhibit Bit Start Inhibit 
000 Reserved 008 | Reserved 
001 | Enable Input Inactive 009 | Reserved 
002 Reserved 010 | Reserved 
003 Reserved 011 | Reserved 
004 | Reserved 012 | Reserved 
005 Reserved 013 | Reserved 
006 Reserved 014 | Reserved 
007 Reserved 015 | Reserved 


5-46.23 Axis Statistical Attributes 
The following table includes attributes that provide useful statistics on motion axis operation. 


Table 5-46.59 Axis Statistical Attributes 


Attr ID Need in Access | N Attribute Name Data Description of Semantics of Values 
Implem Rule Vv Type Attribute 
710 Optional - Get Control Power-up REAL Elapsed time since axis control | Sec 
PVT Time power was last applied. 
711 Optional - Get Cumulative Run Accumulated time that the axis | Hours 
PVT Time has been powering the Running 
state. 
712 Optional - Get Cumulative Energy REAL Accumulated output energy of Kilowatt-Hours 
PVT Usage the axis. 
713 Optional — Get Cumulative Motor Cumulative number of times 
PVT Revs motor shaft has turned. (Rotary 
Motors Only) 
714 Optional - Get Cumulative Main DINT Cumulative number of times 
PVT Power Cycles AC Mains has been cycled. 
715 Optional - Get Cumulative Control | DINT Cumulative number of times 
PVT Power Cycles Control Power has been cycled. 
5-46.24 Axis Info Attributes 


The following table includes attributes that provide information about the associated hardware 
capabilities of Motion Axis Object instance. 


Table 5-46.60 Axis Info Attributes 


Attr ID Need in Access | N Attribute Name Data Description of Semantics of Values 
Implem Rule Vv Type Attribute 
720 Required - Inverter Rated Drive inverter output voltage Volts (RMS) 


PVT Output Voltage rating. This value is hard coded 
in the device. 


721 Required - Inverter Rated Drive inverter output current Amps (RMS) 
PVT Output Current rating. This value is hard coded 
in the device. 
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Attr ID Need in Access | N Attribute Name Data Description of Semantics of Values 
Implem Rule Vv Type Attribute 
722 Required - Get Inverter Rated Drive inverter output power Kilowatts 
PVT Output Power rating. This value is hard coded 
in the device. 
723 Optional - Get Converter Rated Drive converter output current Amps 
PVT Output Current rating. This value is determined 
by the motion axis from the 
associated converter. 
724 Optional - Get Converter Rated Drive converter output power Kilowatts 
PVT Output Power rating. This value is determined 
by the motion axis from the 
associated converter. 


5-46.25 General Purpose I/O Attributes 


The following table includes attributes that provide to general purpose analog and digital I/O 
associated with the Motion Axis Object instance. 


Table 5-46.61 Drive General Purpose I/O Attributes 


Attr ID Need in Access | N Attribute Name Data Type Description of Semantics of Values 
Implem Rule Vv Attribute 
730 | Optional - Get Digital Inputs A 32-bit word with whose bits Vendor Specific 
PVT can be assigned by the vendor Bit Map 
to general purpose digital 
inputs. 
731 Optional - Set Digital Outputs A 32-bit word with whose bits Vendor Specific Bit 
PVT can be assigned by the vendor Map 
to general purpose digital 
outputs. 


732 Optional - Get Analog Input 1 REAL General purpose analog input 1 | % Full Scale 
PVT level. 

733 Optional - Get Analog Input 2 REAL General purpose analog input 2 | % Full Scale 
PVT level. 

734 Optional - Set Analog Output 1 REAL General purpose analog output | % Full Scale 
PVT 1 level. 

735 Optional - Set Analog Output 2 REAL General purpose analog output | % Full Scale 
PVT 2 level. 


5-46.26 Local Mode Attributes 


The following attributes tables contain all local mode attributes associated with a Motion Axis 
Object instance. These attributes govern the behavior of the Motion Axis Object instance when 
a local (i.e. non-CIP Motion) device interface requests control of axis behavior. 
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Table 5-46.62 Local Mode Configuration Attributes 


Attr ID Need in Access N Attribute Name Data Description of Semantics of Values 
Implem Rule Vv Type Attribute 


750 Optional Set Local Control USINT Mechanism for controller to Enumeration: 
allow a local interface to 0 = Local Control 
request local control. Control | Not Allowed 
implies in this case the ability | 1 = Local Control 
to change the state or behavior | Conditionally 
of the axis. pllowed 

2 = Local Control 
Local Control Not Allowed Allowed (O) 
configures the device to 
prevent a local interface from 
taking control of the axis. 
Local Control Conditionally 
Allowed configures the device 
to prevent a local interface 
from taking control of the axis 
while the axis is in an 
Operational State, such as 
Running or Testing. 
Local Control Allowed configures 
the device to allow a local 
interface to take control of the 
axis, even in an Operational State. 
Some devices may not support 
this state. 


5-46.27 Common Services 


The Motion Axis Object provides the following CIP Common Services. 
Table 5-46.63 Motion Axis Object - CIP Common Services 


Service Need in Service Name Description of Service 
Code Implementation 


en 


O3nex | Required | Required | Get_Attributes_List Returns the contents of the selected gettable attributes 
for given instance. 

O4nex | Required | Required | Set_Attributes_List Sets the content of the selected settable attributes for 
given instance. 

OEhex | Required | Required |Get_Attributes_Single | Returns the contents of the selected gettable attribute 
for given instance. 

10hex | Required | Required | Set_Attributes_Single | Sets the content of the selected settable attribute for 
given instance. 


1Chex |Optional |N/A GroupSync Passes controller’s System Time Offset to drive and 
reports if this drive can be synchronized with the 
controller as part of a group of associated drives. If the 
drive can be synchronized, the drive also returns the 
drive’s System Time Offset to the controller in the 
response. 
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Service Specific Data 


Common Services supported by the Motion Axis Object have associated Request Data and 
Response Data. The format and syntax of the Service Specific Data depends on the specified 
Service Code. Descriptions of the Service Specific Data for the Set_Attribute_List, 
Get_Attribute_List, Set_Attribute_Single and Get_Attribute_Single services are already 
defined in Appendix A. A description of the Service Specific Data associated with the 
GroupSync service added as part of the CIP Sync extensions to CIP is detailed in the following 
section. 


GroupSync Service 


The GroupSync service is used to synchronize the Motion Axis Object associated with this 
drive node to the controller issuing the service request and, ultimately, to all other drives 
comprising the controller’s Motion Group. The service request passes the controller’s System 
Time Offset and replies with a 1 if the drive is presently group synchronized to the IEEE-1588 
time master or a 0 if it is not group synchronized. 


Table 5-46.64 GroupSync Service Request Data Structure 


Name Description of Request Parameter Semantics of Values 


System Time LINT Specifies the current System Time Offset of the Nanoseconds (CIP Sync 
Offset controller: Absolute) 


The System Time Offset value is used to initialize the last Controller Time Offset value used as 
part of the System Time Offset Check and Compensation algorithm. 


Table 5-46.65 GroupSync Service Response Data Structure 
Name Type Description of Response Parameter Semantics of Values 
Test Status BOOL Boolean value that indicates whether or not the | 0 = drive not synchronized 
drive is presently group synchronized. 1 = drive synchronized 
System Time LINT Specifies the current System Time Offset of the | Nanoseconds (CIP Sync 
Offset drive: Absolute) 


There are two class attributes used by the Motion Axis Object to determine if the drive is group 
synchronized. 


1. Sync Update Delay 
2. Sync Threshold 


The Sync Update Delay attribute determines the minimum time to wait after the last System 
Time Offset change greater than Sync Threshold before the device is considered to be group 
synchronized. This value is the product of the number of networks hops the device is away 
from the grandmaster, as determined by the Time Sync object attribute, Steps Removed, and 
the time synchronization interval, as determined by the Time Sync object attribute, Sync 
Interval. The Sync Update Delay attribute is typically several seconds. 


The Sync Threshold is the value used to determine if the device’s local clock is frequency 
synchronized to the master System Time clock. System Time Offset changes at the motion 
device that exceed the Sync Threshold are considered adjustments to the System Time 
reference system rather than minor adjustment due to local clock drift. This kind of adjustment 
is indicative of a motion device whose local clock is not yet fully synchronized to the master 
clock. Though application dependent, the minimum Sync Threshold value depends on the 
motion device’s time sync implementation, but is typically on the order of microseconds for a 
hardware assisted clock implementation. 
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Once the controller and all the devices in the Motion Group are group synchronized, the 
controller can then set the Synchronous Control bit in the Controller-to-Device Connection 
header of the next cyclic packet sent to the motion devices indicating that the device can 
schedule its next Device-to-Controller Connection update based on the Controller Time Stamp 
and Controller Update Period contained in the connection data. The motion device indicates 
that it is now sending scheduled connection data based on the Controller Update Period by 
setting the Sync Mode bit in the Device-to-Controller Connection header of the next cyclic 
packet sent to the controller. Data exchange between the controller and the device proceed 
thereafter according the CIP Motion Timing Model. 


Object Specific Services 


The Motion Axis Object provides the following Object Specific Services. 
Table 5-46.66 Motion Axis Object — Object Specific Services 


Service Need in Implementation Service Name Description of Service 


ABhex Required Get Axis Attributes List Returns the contents of the selected 
gettable Motion Axis Object attributes. 

AChex Required Set Axis Attributes List Sets the content of the selected settable 
Motion Axis Object attributes. 

4D hex Required Set Cyclic Write List Sets the attribute contents of the Cyclic 
Write Data block. 

AE hex Required Set Cyclic Read List Sets the attribute contents of the Cyclic 
Read Data block. 

4Prex Optional - FC | Run Motor Test Initiates the selected test on the motor 
to measure various motor parameters. 

50hex Optional - FC | Get Motor Test Data Returns the results of the preceding 
Run Motor Test service. 

5lhex Required -C_ | Run Inertia Test Initiates the selected test on the motor 
to measure the inertia. 

52hex Required -C_ | Get Inertia Test Data Returns the results of the preceding 
Run Inertia Test service. 

5 Bhex Required Run Hookup Test Initiates the selected test to determine 
the condition of the motor and feedback 
device connections. 

5Shex Required Get Hookup Test Data Returns the results of the preceding 
Run Hookup Test service. 


Service Specific Data 


Object Specific Services supported by the Motion Axis Object have associated Request Data 
and Response Data. The format and syntax of the Service Specific Data depends on the 
specified Service Code. All parameters contained in the Service Specific Data are word 
aligned. This is true regardless of whether the service specific request data is passed in the 
Controller-to-Device Connection or as part of an Explicit messaging connection. A description 
of the Service Specific Data associated with each service is shown below. 
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5-46.30.1 Get Axis Attribute List 


The Get Axis Attribute List service provides a mechanism to read the current value of one or 
more Motion Axis Object attributes, including attributes having a multi-dimensional array data 
type. The buffer/array transfer mechanism can be used to transfer large data log arrays from the 
device to facilitate features like high speed trending. 

The format of the Request Data Block for this service is shown below. 

Figure 5-46.16 Get Axis Attribute List Request Format 


€ 32-bit Word > 
Get Axis Attribute List Request Format 


Number of Attributes - 


Attr ID 1 Attr 1 Element Size 


Attr Start Index 1 (array only) Attr Data Elements 1 (array only) 

Attr ID 2 Attr 2 Element Size 
Attr Start Index 2 (array only) Attr Data Elements 2 (array only) 

Attr [Dn Attr n Element Size 
Attr Start Index n (array only) Attr Data Elements n (array only) 


Definitions of the individual parameters in this data structure are as follows: 


e Number of Attributes — represents the number of attributes contained in the Get Axis 
Attribute service request. 

e Attr ID — identifies the targeted Motion Axis Object attribute to get. 

e Attr Dimension — determines the dimension of the attribute array. A dimension of zero 
means the attribute is a singular data element and, therefore, not really an array at all. 
Multidimensional arrays (dimension > 1) are supported by adding additional Attr Start 
Index and Addr Data Elements values. If there is an error associated with a specific 
requested get attribute operation the device shall indicate this by setting the Attr Dimension 
to OxFF, in which case the Element Size field contains the specific error code. When an 
error code is present neither the array index parameters nor the attribute data fields are 
returned. 

e Attr Element Size — determines the size, in bytes, of the attribute data element. Data 
elements must be word aligned; 32-bit words are 32-bit aligned and 16-bit words are 16-bit 
aligned. Padding may be added to maintain word alignment. If there is an error associated 
with a specific requested get attribute operation the Element Size field contains the CIP 
General Status error code. When an error code is present neither the array index parameters 
nor the attribute data fields are returned. 

e = Attr Start Index — identifies the starting index for the array of attribute values in the Attr 
Data section. This field is only present when the attribute data type is an array (i.e., 
dimension > 0). 

e Attr Data Elements — determines the number of data element values in the Attr Data 
section for the associated index. This field is only present when the attribute data type is an 
array (i.e., dimension > 0). 


The structure of Response Data Block for this service is as follows: 
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Figure 5-46.17 Get Axis Attribute List Response Format 


€ 32-bit Word > 
Get Axis Attribute List Response Format 


Number of Attributes - 


Attr ID 1 Attr 1 Element Size 


Attr Start Index 1 (array only) Attr Data Elements 1 (array only) 


Attr Data 1 


Attr 2 Dimension 


Attr Data Elements 2 (array only) 


Attr ID 2 
Attr Start Index 2 (array only) 


Attr 2 Element Size 


Attr Data 2 


Attr [Dn 
Attr Start Index n (array only) 


Attr n Element Size 


Attr n Dimension 


Attr Data Elements n (array only) 


Attr Data n 


Definitions of the individual parameters in this data structure are identical to the request data 
structure with the addition of the Attribute Data element, which is defined as follows: 


e Attr Data — contains the current value(s) of the targeted Motion Axis Object attribute 
indicated by the Attr ID. If the attribute is an array, the value(s) are listed according to the 
Attr Start Index and the number of Attr Data Elements. For multidimensional arrays 
(dimension > 1), the sequence of data move sequentially through the indices from right to 
left. Here are some examples, 


Figure 5-46.18 illustrates a Get_Attribute_List Request for a simple 4-byte DINT scalar 
attribute. Note that since the Attr Dim is 0, the Attr Start Index and Attr Data Element fields are 
omitted. 


Figure 5-46.18 — Get Axis Attribute List Response — Example 1 


Get Axis Attribute List Response — 0 Dimensional Data Example 


Number of Attributes = 1 
Attr ID = 25 


Attr Elem Size = 4 


Attr Data = ? 


Figure 5-46.19 illustrates a Get_Attribute_List Request for the first three elements of a one- 
dimensional array attribute that is a UINT. Since the Attr Elem Size for this attribute is a 2-byte 
value, a Pad byte is added to maintain word alignment for any connection data to follow. 
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Figure 5-46.19 — Get Axis Attribute List Response — Example 2 


Get Axis Attribute List Response — 1 Dimensional Array Example 
Number of Attributes = 1 - 


Attr ID = 43 Attr Elem Size = 2 


Attr Start Index 1 = 0 Attr Data Elements 1 = 3 
Attr Data (0) = ? Attr Data (1) =? 
Attr Data (2) = ? (Pad) 


Figure 5-46.20 illustrates a Get_Attribute_List Response for six elements of a two-dimensional 
array of REALs. Note that the Attr Data sequences through the left most array index first 
beginning with the Attr Start Index 1 of 0. 


Figure 5-46.20 Get Axis Attribute List Response — Example 3 


Get Axis Attribute List Response — 2 Dimensional Array Example 


Number of Attributes = 1 
Attr ID = 27 
Attr Start Index 1 = 0 
Attr Start Index 2 = 2 


Attr Data Elements 1 = 2 


Attr Data Elements 2 = 3 


Attr Data (0, 2) =? 
Attr Data (0, 3) =? 
Attr Data (0, 4) = ? 
Attr Data (1, 2) =? 
Attr Data (1, 3) =? 
Attr Data (1, 4) =? 


If there is an error associated with a specific requested get attribute operation the device shall 
indicate this by setting the Attr Dimension to OxFF, in which case the Element Size field may 
contain the specific error code. When an error code is present neither the array index 
parameters nor the attribute data fields are returned. Figure 5-46.21 below illustrates such a 
case, where Attribute 29 is not supported by the targeted motion axis as indicated by the CIP 
General Status Code of 0x14. 


Figure 5-46.21 Get Axis Attribute List Response — Example 4 


Get Axis Attribute List Response — Attribute Error Example 


Number of Attributes = 3 
Attr ID = 25 


Attr Dim = 0 Attr Elem Size = 4 


Attr Data = 43.5 


Attr ID = 29 Attr Dim = OxFF Error Code = 0x14 
Attr ID = 43 Attr Elem Size = 2 


Attr Start Index 1 = 0 Attr Data Elements 1 = 3 
Attr Data [0] = 55 Attr Data [1] = 45 
Attr Data [2] = 35 (Pad) 
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5-46.30.2 Set Axis Attribute List 


The Set Axis Attribute List service provides a mechanism to write a value to one or more 
settable Motion Axis Object attributes, including attributes having a multi-dimensional array 
data type. The buffer/array transfer mechanism can be used to build parameter tables in the 
drive for indexing, or camming applications. 


The format of the Request Data Block for this service is shown below. 


Figure 5-46.22 Set Axis Attribute List Request Format 


€ 32-bit Word > 
Set Drive Attribute List Request Format 


Number of Attributes 
Attr ID 1 
Attr Start Index 1 (array only) 


Attr 1 Element Size 


Attr 1 Dimension 


Attr Data Elements 1 (array only) 


Attr Data 1 


Attr ID 2 Attr 2 Element Size 


Attr Start Index 2 (array only) 


Attr 2 Dimension 


Attr Data Elements 2 (array only) 


Attr Data 2 


Attr ID 3 Attr n Element Size 


Attr Start Index n (array only) 


Attr n Dimension 


Attr Data Elements n (array only) 


Attr Data 3 


Definitions of the individual parameters in this data structure are as follows: 


e Number of Attributes — represents the number of attributes contained in the Set Axis 
Attribute service request. 

e Attr ID — identifies the targeted Motion Axis Object configuration attribute to set. 

e Attr Dimension — determines the dimension of the attribute array. A dimension of zero 
means the attribute is a singular data element and, therefore, not really an array at all. 
Multidimensional arrays (dimension > 1) are supported by adding additional Attr Start 
Index and Addr Data Elements values prior to the Attr Data sequence. 

e Attr Element Size — determines the size, in bytes, of the attribute data element. Data 
elements must be word aligned; 32-bit words are 32-bit aligned and 16-bit words are 16-bit 
aligned. Padding may be added to maintain word alignment. 

e =©Attr Start Index — identifies the starting index for the array of attribute values in the Attr 
Data section. This field is only present when the attribute data type is an array (i.e., 
dimension > 0). 

e Attr Data Elements — determines the number of data element values based on the start 
index that included in the Attr Data section. This field is only present when the attribute 
data type is an array (i.e., dimension > 0). 


— 5-497 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 6 


Motion Axis Object, Class Code: 42hex 


e Attr Data — contains the new value(s) that are to be applied to the targeted drive 
configuration attribute indicated by the Attr ID. If the attribute is an array, the new value(s) 
are applied according to the Attr Start Index and the number of Attr Data Elements. For 
multidimensional arrays (dimension > 1), the list of Addr Data elements moves 
sequentially through the indices from left to right. The data type of the Attr Data must 
match the data type of the attribute specified by the Attr ID. 


Figure 5-46.23 illustrates a Set_Attribute_List Request for a simple 4-byte scalar attribute. 
Note that since the Attr Dim is 0, the Attr Start Index and Attr Data Element fields are omitted. 


Figure 5-46.23 Set Axis Attribute List Request — Example 1 


Set Axis Attribute List Request — 0 Dimensional Data Example 


Number of Attributes = 1 
Attr ID = 25 


Attr Elem Size = 4 


Attr Data =? 


Figure 5-46.24 illustrates a Set_Attribute_List Request for the first three elements of a one- 
dimensional array of UINTs. Since the Attr Elem Size is 2-bytes, a Pad byte is added to 
maintain word alignment for any connection data to follow. 


Figure 5-46.24 Set Axis Attribute List Request — Example 2 


Set Axis Attribute List Request — 1 Dimensional Array Example 
Number of Attributes = 1 - 


Attr ID = 43 Attr Elem Size = 2 


Attr Start Index 1 = 0 Attr Data Elements 1 = 3 
Attr Data (0) = ? Attr Data (1) =? 
Attr Data (2) =? (Pad) 


Figure 5-46.25 illustrates a Set_Attribute_List Request for six elements of a two-dimensional 
array of REALs. Note that the Attr Data sequences through the left most array index first 
beginning with the Attr Start Index 1 of 0. 


Figure 5-46.25 Set Axis Attribute List Request — Example 3 


Set Axis Attribute List Request — 2 Dimensional Array Example 


Number of Attributes = 1 
Attr ID = 27 
Attr Start Index 1 = 0 
Attr Start Index 2 = 2 


Attr Data Elements 1 = 2 


Attr Data Elements 2 = 3 


Attr Data (0, 2) =? 
Attr Data (0, 3) =? 
Attr Data (0, 4) = ? 
Attr Data (1, 2) =? 
Attr Data (1, 3) =? 
Attr Data (1, 4) = ? 


The structure of Response Data Block for this service is as follows: 
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Figure 5-46.26 Set Axis Attribute List Response Format 


€ 32-bit Word > 
Set Axis Attribute List Response Format 


Number of Attributes 
Attr ID 1 
Attr ID 2 


Attr Status 2 


e Attr ID — identifies the targeted Motion Axis Object configuration attribute of the set list 
request. 

e Attr Status — indicates whether the set list action for the targeted attribute was successful. 
An Attribute Status value is zero if the targeted attribute was successfully written. A non- 
zero Attr Status value indicates that an error occurred that prevented the attribute from 
being updated. The error codes follow the CIP General Status Codes. 


5-46.30.3 Set Cyclic Write List 


The Set Cyclic Write List service provides a mechanism to determine the list of attributes to be 
passed as part of the Cyclic Write Data Block of the Controller-to-Device connection. The 
format of the Request Data Block for this service is shown below. 


Figure 5-46.27 Set Cyclic Write List Request Format 


€ 32-bit Word > 
Set Cyclic Write List Request Format 


Number of Attributes - 
Attr ID 1 Attr ID 2 


Number of Attributes — represents the number of attributes contained in the Cyclic Write List. 


Attr ID — identifies the specific drive configuration attribute that is to be updated via the 
Cyclic Write Data Block of the Controller-to-Device connection. The Attr ID determines the 
data type and implied semantics of the data based on the specifications for the associated 
attribute. 


The ordering of the attribute data in the Cyclic Write Data Block is determined by the ordering 
of the Attr IDs in the Set Cyclic Write List request. Attribute data elements must be word 
aligned; 32-bit words are 32-bit aligned and 16-bit words are 16-bit aligned. Padding may be 
added to maintain word alignment. 


The structure of Response Data Block for this service is as follows: 
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Figure 5-46.28 Set Cyclic Write List Response Format 


€ 32-bit Word > 
Set Cyclic Write List Response Format 


Number of Attributes 
Attr ID 1 
Attr ID 2 


Cyclic Write Block ID 
Attr Status 1 


Attr Status 2 


Number of Attributes — represents the number of attributes contained in the requested Cyclic 
Write List. 


Cyclic Write Block ID - If all attributes in the requested list can be supported in the Set Cyclic 
Write Data Block, the Set Cyclic Write List response provides a new Cyclic Write Block ID 
that is simply the increment of the current Cyclic Write Block ID. This new Cyclic Write Block 
ID can be used in the next Controller-to-Device Connection update. If the Set Cyclic Write List 
is not successful, the Cyclic Write Block ID remains the current value. 


Attr ID — identifies the specific drive configuration attribute that was requested to be updated 
via the Cyclic Write Data Block of the Controller-to-Device Connection. 


Attr Status — The Attr Status value is zero if the associated attribute indicated by the Attr ID 
can be supported in the Set Cyclic Write Data Block. A non-zero Attr Status code indicates the 
specific reason why the associated attribute cannot be supported. These codes follow the CIP 
General Status Codes. If the Attr Status of one or more Attribute IDs in the list indicates an 
error, the Set Cyclic Write List request is considered unsuccessful. 


Set Cyclic Read List 


The Set Cyclic Read List service provides a mechanism to determine the list of attributes to be 
passed as part of the Cyclic Read Data Block of the Device-to-Controller connection. The 
format of the Request Data Block for this service is shown below. 


Figure 5-46.29 Set Cyclic Read List Request Format 
€ 32-bit Word > 


Set Cyclic Read List Request Format 
Number of Attributes - 
Attr ID 1 Attr ID 2 


Number of Attributes — represents the number of attributes contained in the Cyclic Read List. 


Attr ID — identifies the specific drive status or signal attribute that is to be updated via the 
Cyclic Read Data Block of the Device-to-Controller connection. The Attr ID determines the 
data type and implied semantics of the data based on the specifications for the associated 
attribute. 


The ordering of the attribute data in the Cyclic Read Data Block is determined by the ordering 
of the Attr IDs in the Set Cyclic Read List request. Attribute data elements must be word 
aligned; 32-bit words are 32-bit aligned and 16-bit words are 16-bit aligned. Padding may be 
added to maintain word alignment. 


The structure of Response Data Block for this service is as follows: 
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Figure 5-46.30 Set Cyclic Read List Response Format 


€ 32-bit Word > 
Set Cyclic Read List Response Format 


Number of Attributes 
Attr ID 1 
Attr ID 2 


Cyclic Read Block ID 


Number of Attributes — represents the number of attributes contained in the requested Cyclic 
Read List. 


Cyclic Read Block ID - If all attributes in the requested list can be supported in the Set Cyclic 
Read Data Block, the Set Cyclic Read List response provides a new Cyclic Read Block ID that 
is simply the increment of the current Cyclic Read Block ID. This new Cyclic Read Block ID 
can be used in the next Device-to-Controller Connection update. If the Set Cyclic read List is 
not successful, the Cyclic Read Block ID remains the current value. 


Attr ID — identifies the specific drive configuration attribute that was requested to be updated 
via the Cyclic Read Data Block of the Device-to-Controller connection. 


Attr Status — The Attr Status value is zero if the associated attribute indicated by the Attr ID 
can be supported in the Set Cyclic Read Data Block. A non-zero Attr Status code indicates the 
specific reason why the associated attribute cannot be supported. These codes follow the CIP 
General Status Codes. If the Attr Status of one or more Attribute IDs in the list indicates an 
error, the Set Cyclic Read List request is considered unsuccessful. 


Run Motor Test 


The Run Motor Test service initiates various test operations motor to determine important 
motor parameters. The Static Test applies a directionally static flux to the motor, while the 
Dynamic Test performs dynamic tests on the motor that produce motion. The parameters 
measured by these tests are retrieved by the controller via the Get Motor Test Data command. 


Table 5-46.67 Run Motor Test Request Data Structure 


Name Description of Request Parameter Semantics of Values 


Test Direction Enumeration that selects test direction: Enumeration: 

0 = forward 

1 = reverse 

2 = forward bi-directional 
3 = reverse bi-direction 


Test Type Enumeration that specifies the type of test | Enumeration: 
to perform: 0 = static test 
1 = dynamic test 


There are no specific response parameters required for this service. 
Get Motor Test Data 


The Get Motor Test Data service provides access to the motor parameter measurements 
generated by the last Motor Test command. The controller uses this data to update the device 
with the best estimates of critical motor parameters. 
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There are no specific request parameters required for this service. 


Table 5-46.68 Get Motor Test Response Data Structure 


Name Type Description of Response Parameter Semantics of Values 


Test Status Indicates the result of the last Motor Test | Enumeration: 

command: 0 = test process successful 
1 = test in progress 
2 = test process aborted 
3 = test process timed-out 
4 = test process faulted 


Stator Resistance REAL Measured phase-to-phase stator resistance } Ohms 
of the motor. 
REAL Measured phase-to-phase leakage Henries 
inductance of the motor. 
REAL Measured current to achieve full induction | Amps 
motor flux. (IM only) 
REAL Measured slip at rated induction motor Hertz 
current. (IM only) 


5-46.30.7. Run Inertia Test 


Leakage Inductance 


Flux Current 


Slip Frequency 


The Run Inertia Test service performs an acceleration and deceleration ramp on the axis and 
makes timing measurements in the process. The timing measurements are accessed by the 
controller via the Get Inertia Test Data command and ultimately used to calculate an accurate 
inertia value for the motor and load. 


Table 5-46.69 Run Inertia Test Request Data Structure 


Name Description of Request Parameter Semantics of Values 


Test Direction Enumeration that selects test direction: Enumeration: 
0 = forward 


1 = reverse 
Test Velocity REAL Determines the maximum velocity that will | Velocity Feedback Counts / Sec 
be reached during the test profile. 
Test Torque i 


REAL Determines the maximum torque that is % Motor Rated 
applied during the test profile. 


Test Travel Limit REAL Establishes the maximum excursion of the | Feedback Counts 
axis in Feedback Counts allowed in the test 


direction. 


There are no specific response parameters required for this service. 
5-46.30.8 Get Inertia Test Data 


The Get Inertia Test Data service provides access to the timing measurements generated by the 
last Run Inertia Test service. The controller uses this data to ultimately calculate an accurate 
inertia value for the motor and load. 


There are no specific request parameters required for this service. 
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Table 5-46.70 Get Inertia Test Response Data Structure 


Name Description of Response Parameter Semantics of Values 


Test Status Enumeration that indicates the result of the | Enumeration: 

last Run Inertia Test service: 0 = test process successful 
1 = test in progress 
2 = test process aborted 
3 = test process timed-out 
4 = test process fault 
5 = test reached limit 
6 = test polarity incorrect 
7 = test speed set too low 


Accel Time REAL Measured acceleration time to reach test Sec 
velocity. 

Decel Time REAL Measured deceleration time to reach zero Sec 
speed from test velocity. 


Run Hookup Test 


The Run Hookup Test service performs a number of different tests to check for proper interface 
to the motor and/or feedback device. Three tests are currently supported. The Motor/Feedback 
test is an active test that attempts to move the axis a specified distance given by the Test 
Increment. The Feedback test monitors the axis while an external agent moves it and indicates 
success if the axis feedback count exceeds the distance specified by the Test Increment. 
Finally, the Commutation Test, which applies only to PM motors, applies current to the motor 
to align the rotor, check for proper phasing of a Hall sensor if applicable, and measure the 
Commutation Offset. The resultant data generated by these test can be accessed by the Get Test 
Data service and used by the controller to automatically set the proper polarities of the 
feedback interface and the motor interface. 


Table 5-46.71 Run Hookup Test Request Data Structure 


Name Type Description of Request Parameter Semantics of Values 


Test Increment Establishes the distance that the axis needs | Feedback Counts 
to travel, in Feedback Counts to indicate a 
successful test. 


Hookup Test Determines the specific test to run: Enumeration: 
0 = motor/feedback test 
1 = feedback test 


2 = commutation test 


There are no specific response parameters required for this service request. 
Get Hookup Test Data 


The Get Hookup Test Data service provides access to the hookup test results generated by the 
last Run Hookup Test service. The controller uses this data to flag a wiring problem to the user 
and to calculate polarity configuration bit parameters for the axis. 


There are no specific request parameters required for this service. 
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Table 5-46.72 Get Hook-up Test Response Data Structure 


Name Description of Response Parameter Semantics of Values 


Test Status USINT Enumeration that indicates the result of Enumeration: 
the last Hookup Test command: 0 = test process successful 
1 = test in progress 
2 = test process aborted 
3 = test process timed-out 
4 = test process faulted 
Test Direction USINT Enumeration that indicates the direction of | Enumeration: 
Forward axis motion associated with the last 0 = forward 
Hookup Test command. 1 = reverse 
Hall Commutation USINT When performing a Commutation Test on | Enumeration: 
Map a PM motor feedback device the test 0 = UVW (normal) 


checks if the UVW phases of the Hall 1=UWV 
Sensor match the UVW phases of the 2=WVU 
Motor. If it is determined that the UVW 3 = WUV 


4= VUW 


phases for the motor and hall device do 
not match, typically due to incorrect 
wiring, this parameter reports the 5 = VWU 
necessary commutation map can be used 

to compensate the mismatch. The 

enumerated choices listed assume the 


motor is wired correctly as UVW and 
describes different mappings of the UVW 
Hall sensor inputs that if applied to the 
device would correct the phasing. 


Commutation Offset | REAL Offset measured during the Commutation | Electrical Degrees 
Test that must be applied to the motor 
position accumulator in order to align the 


Electrical Angle signal with motor stator’s 
orientation 


5-46.31 Behavior 
5-46.31.1 State Model 


The Motion Axis Object State Model is based on elements of the S88 and Pack/ML standard 
state models. The current state of the Motion Axis Object instance is indicated by the Axis 
State attribute. State transitions can be initiated either directly via the Axis Control request 
mechanism or by conditions that occur during device operation. The diagram below shows the 
basic operating states of the Motion Axis Object. 


— 5-504 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 6 


Motion Axis Object, Class Code: 42hex 
Figure 5-46.31 Motion Axis Object State Model 
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5-46.31.2 State Control 


The primary method for changing the state of a Motion Axis Object instance is via the Axis 
Control/Axis Response mechanism that is built into the CIP Motion I/O Connection header. 
Changing the state of the motion axis is simply performed by placing the appropriate Request 
Code in the Axis Control element of the Controller-to-Device Connection header. The Control 
Request codes currently defined in this object are as follows: 
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Table 5-46.73 Axis Control Request Code 


Request Code Requested Operation 
0 No Request 
1 Enable Request 
2 Disable Request 
3 Shutdown Request 
4 Shutdown Reset Request 
5 Abort Request 
6 Fault Reset Request 
7-127 Reserved 
128-255 Vendor Specific 


When a State transition is requested via Axis Control element of the Controller-to-Device 
connection, the axis initiates the state transition and then acknowledges the transition request 
via the Axis Response attribute when the requested state transition completes or is determined 
unsuccessful. The Acknowledge Codes for the Axis Response element are the same as the 
Request Codes for the Axis Control element. 


Table 5-46.74 Axis Response Acknowledge Codes 


Acknowledge Axis Response 
Code 
0 No Acknowledge 
1 Enable Acknowledge 
2 Disable Acknowledge 
3 Shutdown Acknowledge 
4 Shutdown Reset Acknowledge 
5 Abort Acknowledge 
6 Fault Reset Acknowledge 
7-127 Reserved 
128-255 Vendor Specific 


The criteria for successful completion of the requested operation depend on the specific 
Request Code as shown in the table below. 


Table 5-46.75 Completion Criteria for Requested Operation 


Request Code Completion Criteria 
1 Axis successfully transitions to Starting state. 
1 Axis successfully transitions to Stopped state. 
3 Axis successfully transitions to Shutdown state 
4 Axis successfully transitions to Stopped or Inhibited state 
5 Axis successfully transitions to Faulted state. 
6 Axis successfully transitions to Stopped, Inhibited, or Shutdown state. 
7-127 Reserved 
128-255 Vendor Specific 
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When the controller receives the Acknowledge Code, it then zeroes the matching Request 
Code. When the drive sees the Request Code zeroed, it clears the Acknowledge Code and the 
associated Response Status. 


If the axis cannot transition to the requested state, the specific error condition is indicated by a 
non-zero Response Status attribute value that is passed along with the Axis Response at part of 
the Device-to-Controller connection. 


In the case of a Fault Reset, if any fault generating exception conditions still exist, an Error 
Code is generated to indicate that the axis cannot transition out of the Faulted State until the 
associated exception conditions have been cleared. 


This behavior is illustrated in the tables below. 


Table 5-46.76 Successful Axis Control Request Cycle 


Controller Action Connection Data Drive Action 


Controller sets Request Code in the > Drive Control = x Drive sees non-zero Request Code, x, 
Axis Control element to request a in Axis Control element and initiates 
state change. the requested state change. 


< Axis Response = x If state change operation is 

€ Response Status = 0 successful, the device acknowledges 
the state change by setting the 
Acknowledge Code in the Axis 
Response element to the originating 
Request Code, x. The Response 
Status element is set to 0 indicating 
success. 


Controller sees the non-zero > Axis Control = 0 
Acknowledge Code in Axis Response 
element and zeroes the originating 
Request Code in the Axis Control 
element. The requested state change 
was successful as evidenced by the 
zero Response Status. 


The state change request transaction |< Axis Response = 0 Drive sees a zero Request Code in the 
is now complete. Another Axis € Response Status = 0 Axis Control element and zeroes the 
Control request can be processed at associated Acknowledge Code in the 
this time. Axis Response element. 
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Table 5-46.77 Unsuccessful Drive Control Request Cycle 


Controller sets Request Code in the > Axis Control = x Drive sees non-zero Request Code, x, 
Axis Control element to request a in Axis Control element and initiates 
state change. the requested state change. 

< Axis Response = x If state change operation is 


€ Response Status = Error Code | unsuccessful, the Drive indicates the 
problem via a non-zero Response 
Status Error Code along with the 
Acknowledge Code matching the 
originating Request Code, x 


Controller sees the non-zero > Axis Control = 0 
Response Status associated with the 
Request Code, x, in the Axis 
Response, handles the error condition 
based on the Error Code, and clears 
the originating Request Code in the 
Axis Control element. 


The state change request transaction | < Axis Response = 0 Drive sees a zero Request Code in the 
is now complete. Another Axis € Response Status = 0 Axis Control element and zeroes the 
Control request can be processed at associated Acknowledge Code in the 
this time. Axis Response element. 


Object state transitions can also be initiated by service requests such as the Test service 
requests. In general, these state change requests use services because they require one or more 
parameters to be passed to the device in order to initiate the state change. 


State Behavior 


The following section offers a detailed description of each of the states and state transitions of 
the Motion Axis Object state model. 


Off State 
This is the state of the Motion Axis Object with power off. 


Self Test State 


When power is applied to the device, or the device is reset, the device typically goes through a 
series of self-test diagnostics and internal device parameters are set to their power-up default 
values. Once completed successfully, the device and all its associated axis instances transition 
to the Initializing state and are ready for initialization by the associated controller. If 
unsuccessful, the device and all its associated axis instances transition immediately to the 
Major Faulted state by declaring an Initialization Fault that is classified as Un-recoverable. 
Clearing this fault can only be accomplished through a power cycle and is most likely the result 
of a device hardware problem.. 
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Initializing State 


During the Initializing state, network connections to the device are established by the 
controller. Once connections are established, the controller sends services to the device to set 
the Motion Axis Object configuration attributes to values stored in the controller. If the device 
supports synchronous operation, the controller then synchronizes with the device using the 
Group Sync service. Once this entire process has been completed successfully, the device and 
all its configured axis instances transition to the Pre-charge state. If a problem is found during 
this initialization process, an Initialization Fault is generated. An Initialization Fault is viewed 
as an unrecoverable fault so clearing the fault can only be accomplished through a power cycle 
or a device reset service to the associated Identity Object. 


Pre-Charge State 


The Pre-Charge state the device is waiting for the DC Bus to fully charge. Once the DC Bus 
reaches an operational voltage level, as indicated by the DC Bus Up bit in the Axis Status 
attribute, the device and all its configured axis instances transition to the Stopped state. Any 
attempt for the controller to enable an axis via the Axis Control mechanism while it is in the 
Pre-charge state is reported back to the controller as an error in the Response Status and the 
axis remains in the Pre-charge state. 


Stopped State 


In the Stopped state the device’s inverter power structure should either be disabled and free of 
torque or held in a static condition via an active control loop. No motion can be initiated by the 
device in the Stopped State nor can the device respond to a planner generated command 
references. In general, the axis should be at rest, but if an external force or torque is applied to 
the load, a brake may be needed to maintain the rest condition. In the Stopped state, main 
power is applied to the device and the DC Bus is at an operational voltage level. If there are 
any Start Inhibit conditions detected while in this state, the axis transitions to the Start Inhibited 
state. If an Enable request or one of the Run Test service requests is applied to an axis in the 
Stopped state, the axis transitions to the Starting state. 


Starting State 


When an Enable request is given to an axis in the Stopped state, the axis immediately 
transitions to the Starting state. In this state, the device checks various conditions before 
transitioning the axis to the Running state. These conditions can include Brake Release delay 
time and Induction Motor flux level. The control and power structures are activated during the 
Starting state but the command reference is set to a local static value and does not track the 
command reference derived from the motion planner. If all the starting conditions are met, the 
axis state transitions to either the Running state or the Testing state. 


Running State 


The Running state is where the work gets done. In this state, the axis’s power structure is active 
and the selected Control Mode is enabled and actively tracking command data from the 
controller based motion planner output to affect axis motion. The motion axis remains in the 
Running state until either a fault occurs or it is explicitly commanded to stop via a Axis Control 
request. 
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Testing State 


When any one of the Run Test request services is sent to the motion axis while in the Stopped 
state the axis immediately transitions to the Starting State, and then once the Starting conditions 
are met, the axis transitions to the Testing state. This Testing state is like the Running state in 
that the axis’s power structure is active, but in the Testing state one of the axis’s built-in test 
algorithms is controlling the motor, not a motion planner. In the Testing state the device excites 
the motor in various ways while performing measurements to determine characteristics of the 
motor and load. The motion axis remains in this state for the duration of the requested test 
procedure and then returns to the Stopped state. The motion axis can also exit the Testing state 
by either a fault or an explicit Axis Control request. 


Start Inhibited State 


The Start Inhibited state is the same as the Stopped state with the exception that the axis has 
one or more “start inhibit” conditions that prevent it from successfully transitioning to the 
Starting state. These conditions can be found in the Start Inhibit Status attribute. Once 
corrected, the axis state automatically transitions back to the Stopped state. 


Stopping State 


When a Disable request is issued to the Motion Axis Object in the Running or the Testing state, 
the axis immediately transitions to the Stopping state. In this state, the axis is in the process of 
stopping. There are a number of different Stopping Modes supported by the Motion Axis 
Object. Once the selected stop mode procedure has completed, the axis transitions to the 
Stopped state. 


Aborting State 


When a Major Fault occurs while the axis is in either the Running or Testing states, the motion 
axis immediately transitions to the Aborting state. The Aborting state executes the appropriate 

stopping action as specified by the device vendor. Once the stopping procedure is complete the 
axis transitions to the Major Faulted state. 


Major Faulted State 


The Major Faulted state is identical to the Stopped state (or, if a Shutdown fault action was 
initiated, the Shutdown state) with the exception that there are one or more Major Faults active. 
In other words, a Major Faulted axis is a Stopped (or Shutdown) axis with a Major Fault 
condition present. Since faults are latched conditions, a Fault Reset request from the controller 
is required to clear the fault and, assuming the original fault condition has been removed, the 
axis transitions to the Stopped (or Shutdown) state. 


Shutdown State 


When a Shutdown request is issued to the device or a Shutdown fault action is executed by the 
device, the targeted axis transitions to the Shutdown state. In the case of a Shutdown request, 
the axis immediately transitions from whatever state it is currently in to the Shutdown state. 
The Shutdown state has the same basic characteristics of the Stopped state except that it can be 
configured to drop the DC Bus power to the device’s power structure. Regardless of whether or 
not DC Bus power is disconnected, this state requires an explicit Shutdown Reset request from 
the controller to transition to the Pre-Charge state. If the axis is configured to keep the DC Bus 
power active while in the Shutdown state then the motion axis transitions through the Pre- 
Charge state to the Stopped state. The Shutdown state offers an extra level of safety against 
unexpected motion. 
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Fault and Alarm Behavior 


The Motion Axis Object’s Fault and Alarm handling functionality addresses both the need for a 
large and ever-expanding number of specific faults and alarms, the need for programmable 
actions, and the need for timely reporting of those faults and alarms to the controller. 
Additionally, no compromises are made to restrict the resolution of the reported faults and 
alarms, so that the controller always has access to the unique axis condition and a meaningful 
diagnosis. Numerous Fault and Alarm related attributes can be included in the fixed portion of 
the cyclic Device-to-Controller Connection so the controller can monitor the condition of the 
motion axis in real-time, without cumbersome polling. 


The Axis Status attribute contains bits to indicate whether an alarm condition is present. The 
Axis State enumeration indicates when the axis has a major fault, which could be either a 
regular runtime Axis Fault or and Initialization Fault. Fault Codes are also provided to report 
the specific fault condition that led to the current Faulted state and covers both major and minor 
Faults. But before we go into detail on this, we must first carefully define the terms used to 
describe the Fault and Alarm functionality of the Motion Axis Object. 


Exceptions 


Exceptions are runtime conditions that the device continually checks that might indicate 
improper behavior of the motion axis or operation outside of an allowable range. An exception 
can result in an alarm, a minor fault, or a major fault, depending on how the associated 
Exception Action has been configured — an exception can even be configured to be ignored. 
Exceptions are automatically cleared by the device when the underlying exception condition is 
no longer present. 


Exception Actions 


For each exception, the motion axis can be programmed a variety of actions via the Exception 
Action attribute. Exception Actions range from generating a major fault that results in the 
stopping of the motion axis all the way to taking no action at all. The Axis Fault Status attribute 
allows the controller to have immediate access to any exceptions that have been configured to 
generate a major or minor fault. The Axis Alarm Status attribute allows the controller to have 
immediate access to any exceptions that have been configured to be reported as alarms. 


Alarms 


Alarms are runtime exception conditions for which the device is to take no action other than to 
report as an alarm. Alarms and warnings, therefore, are basically synonymous. On a given 
device product, some exception conditions may not be able to simply be reported as an alarm 
without any associated action; for example an IPM fault in which the power module 
automatically shuts off without software intervention. Alarm conditions are automatically 
cleared when the underlying exception condition is no longer present. 


Major Faults 


Major Faults are either initialization faults or runtime exception conditions that the device has 
been configured to regard as a major fault. If such a runtime fault occurs during an operational 
state, e.g. Running or Testing, it results in the device stopping (or aborting) all axis motion. 
Major Faults ultimately transition the axis state to the Major Faulted state. A Major Fault that 
results from an exception condition is latched, and does not clear when the exception condition 
clears. A fault can only be cleared with a Fault Reset service request from the controller. If the 
fault condition is classified as an “unrecoverable fault”, only a power cycle or a device reset 
can clear the fault condition. 
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Minor Faults 


Minor Faults are exception conditions that the device has been configured to report to the 
controller as a fault but not take any direct action. This provides the controller an opportunity to 
perform an application specific fault action that may not be supported by the device as one of 
the defined exception actions. Like alarms, Minor Faults do not initiate a state change nor does 
a Minor Faulted state even exist; a Minor Fault allows the motion axis to continue operation in 
the state that it is presently in. But unlike alarms, a Minor Fault is latched, i.e. the fault does not 
clear when the exception condition clears. Both Major and Minor Faults can only be cleared 
with a Fault Reset service request from the controller. Since the motion axis cannot transition 
from the Stopped state to any operational state until the Minor Fault is cleared, a Minor Fault is 
considered a Start Inhibit and is indicated by the Minor Fault bit being set in the Start Inhibit 
Status attribute. 


Initilization Faults 


Initialization Faults are faults that are generated during the power-up or device reset procedure 
when the device detects a problem that prevents normal device operation. This could be a 
hardware or firmware problem detected as part of its self-diagnostic tests or a problem with the 
attribute configuration process. These faults are not sourced by exception conditions and, 
therefore, they do not have configurable actions. Examples of initialization faults are corrupted 
memory data, calibration errors, or firmware startup problems. Initialization Faults that result 
in the Faulted state cannot be cleared with a Fault Reset service, so any kind of motion is 
impossible in this state; only a power-cycle or a Device Reset has a chance of clearing this kind 
of fault. 


Fault Codes 


The Fault Code attribute is an enumeration that indicates the exception condition that generated 
the fault. This attribute does not change unless a Fault Reset service is initiated. The 
Initialization Fault Code attribute is an enumeration that indicates the initialization fault that led 
to the current Faulted state. 


Start Inhibit Behavior 


A Start Inhibit is a condition that inhibits the axis from starting, i.e. transitioning to the Starting 
state for enabled axis operation. This condition does not generate an exception if a start 
attempt is made. If the circumstances that led to the Start Inhibit are no longer present, the start 
inhibit condition is automatically cleared by the device, returning the axis to the Stopped State. 


If the motion axis is in the Start Inhibit state it indicates that one or more conditions are present 
that prevent the axis from transitioning to enabled operation. The Start Inhibit Status attribute 
reports the specific condition that is inhibiting the axis. 


The Start Inhibit Code attribute is an enumeration that indicates a condition that presently is 
causing the axis to be in the Start Inhibit state. If the original inhibiting condition is removed, 
this attribute automatically cleared or else set to another inhibiting condition if one is present. 


Visualization Behavior 


Motion Axis Object state behavior has a direct impact on motion device visualization 
components. These components range from bicolor LEDs to multi-character alphanumeric 
displays. This section defines how the Motion Axis Object states affect the behavior of these 
visualization components. 
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Module Status LED 


Motion Axis Object states have a relationship to the state behavior of the Identity Object of the 
CIP Motion device and to its associated Module Status LED. The table below maps the states 
of the primary Motion Axis Object instance to the appropriate states of the Identity Object. All 
CIP Motion compliant devices are required to support a Module Status LED. 


For more information regarding the Identity Object state model, refer to the Identity Object. 
Axis Status LED 


To further augment the visual information provided by the standard Module Status LED, the 
CIP Motion device profile also defines the behavior of a second LED. This, so called, Axis 
Status LED provides visual indication of, for example, whether or not the DC Bus is energized, 
whether the axis is enabled or disabled, and even provides indication of active alarms or minor 
fault conditions. This LED is also required by CIP Motion compliant devices unless the device 
is equipped with a multi-character alphanumeric display. 


The Axis Status LED uses three colors that can be generated by a standard bicolor Red/Green 
LED, namely Red, Green, and Amber. Amber (or Yellow) is the color produced when both the 
Red and Green junctions of the bicolor LED are on. The general meaning of these three colors 
are as follows: 


Green — indicates a normal power-up or operational state. 
Amber — indicates the presence of an alarm or start inhibiting condition. 
Red — indicates presence of some form of fault condition. 


When both minor fault and alarm conditions are present, the minor fault indication takes 
precedence. 


The normal power up or device reset, both the Module Status and Axis Status LEDs shall start 
in the Red state (under hardware control) while the device processor is booting and then switch 
to the Green state for approximately 1 second once the device begins executing its self test. 
Ideally, both LEDs should be Red for approximately 1 second and then Green for 
approximately 1 second prior to transitioning to a Standby state indication. This Red-Green 
sequence confirms proper operation of the LED indicators. 
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Table 5-46.78 Axis State Mapping to Identity Object with LED Behavior 


Identity Object State | Module Status LED Motion Axis Object State Axis Status LED 


Nonexistent — Power 
Device Self-Testing Flash Red/Green Self Test Flash Red/Green 


Initialization — Bus not Up Off 
Initialization — Bus Up Flashing Green 


Standby Flashing Green Shutdown — Bus not Up Off 


Shutdown — Bus Up Flashing Amber * 


Pre-Charge - Bus not Up Off 
Start Inhibit Flashing Amber * 


Stopped Flashing Green '* 
Stopping Solid Green !* 
Operational Solid Green Starting Solid Green '* 
Running Solid Green !* 
Testing Solid Green !* 


Major Recoverable . Aborting Flashing Red 
Flashing Red 
Fault Major Faulted Flashing Red 
j Abortin Solid Red 
Major Unrecoverable Solid Red Ing 1 
Fault Major Faulted Solid Red 


1. The Motion Axis Object and the Identity Object define minor fault conditions. While a minor fault does 
not affect the Module Status LED, it does affect the Axis Status LED. When a minor fault condition is 
detected a normally Solid Green LED indication changes to alternating Red-Green-Red-Green, a normally 
Flashing Green LED indication changes to alternating Red-Off-Green-Off, and a normally Flashing Amber 
indications changes to Red-Off-Amber-Off. 

2. The Motion Axis Object also defines alarm conditions. When an alarm condition is detected, a normally 
Solid Green LED indication changes to alternating Amber-Green-Amber-Green while a normally Flashing 
Green LED indication changes to alternating Amber-Off-Green-Off. 


5-46.35.3 Alphanumeric Display 


In addition to the required LED visualization provided by the Module Status LED and Axis 
Status LED the Motion Axis Object also defines the behavior of an optional alphanumeric 
display to more explicitly indicate the condition of the device. Such a display is particularly 
useful for monitoring progress through the initialization process and providing detailed 
diagnostic information concerning fault, alarm, and inhibit conditions. Alphanumeric displays 
can range from simple seven-segment displays to multi-character alphanumeric displays. 


5-46.35.4 Seven-Segment Display 


If the device is equipped with a seven-segment display, the display can be used to indicate 
progress through the Initialization state and various fault, alarm, and inhibit conditions. At a 
minimum, the display should support the following mapping to various conditions of the 
device. 
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Table 5-46.79 CIP Motion Device Seven-Segment Display Behavior 


Display Digit Drive Condition 
8 Executing drive Self-Test 
0 Waiting for connection to controller. 
1 Configuring device attributes. 
2 Waiting for group synchronization. 
3 Waiting for DC Bus to charge. 
4 Device is operational 
T## Initialization Fault Code 
IE## Initialization Fault Code - Manufacturer extensions 
FH# Axis Fault Code 
FE## Axis Fault Code - Manufacturer extensions 
A#t# Alarm Code 
AE## Alarm Code - Manufacturer extensions 
S## Start Inhibit Code 
SE## Start Inhibit Code - Manufacturer extensions 


5-46.35.5 Multi-Character Alphanumeric Display 


If the device is equipped with a multi-character alphanumeric display, even more useful device 
information can be conveyed to the user via scrolling or static character fields. The capabilities 
of the display generally dictate the length of the character strings that can be effectively 
displayed. Therefore, the CIP Motion Device Profile does not dictate exactly what is displayed. 
Nevertheless, for the purpose of enforcing consistent behavior among devices compliant with 
the CIP Motion Device Profile, the Motion Axis Object dictates exactly what is displayed for 
the conditions outlined in the table below. 


Table 5-46.80 CIP Motion Multi-Character Alphanumeric Display Behavior 


Display String Device Condition 
SELF-TEST Executing device Self-Test 
CONNECTING Connecting (waiting for Forward_Open) 
CONFIGURING Configuring Motion Device Attributes 
SYNCING Synchronizing (waiting for GroupSync) 
PRE - CHARGE Waiting for DC Bus Up 
SHUTDOWN Axis has been Shutdown 
STOPPED Axis has stopped 
INHIBITED Axis is Start Inhibited 
STARTING Axis is Starting 
RUNNING Axis is Running 
TESTING Axis is executing a Test procedure 
STOPPING Decelerating to a stop as a result of a disable 
ABORTING Decelerating to a stop as a result of a fault 


INIT FLT S## 
INIT FLT M## 


Initialization Fault — Std and Fault Code 
Initialization Fault - Mfg and Fault Code 


FLT S## Fault — Std. and Fault Code 
FLT M## Fault — Mfg and Fault Code 
ALARM S## Initialization Fault — Std and Fault Code 
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Display String Device Condition 
ALARM Mé### 
INHIBIT S## 


INHIBIT M## 


Initialization Fault - Mfg and Fault Code 
Initialization Fault — Std and Fault Code 


Initialization Fault - Mfg and Fault Code 


In addition to this basic functionality, the alphanumeric display can also provide detailed text 
descriptions of fault, alarm, and inhibit conditions. Definition of these specific strings is well 
beyond the scope of this object and is left to the discretion of the device vendor. 


Multi-Axis Device Visualization 


In the case where there are multiple motion axis instances supported by the device the above 
behavior needs further explanation. 


First of all, there is only one Module Status LED per device node, so its condition is a roll-up 
of the states of all the Motion Axis Object instances. By contrast, one Axis Status LED is 
associated with each Motion Axis Object instance in the motion device that has a power 
structure. A single multi-character alphanumeric display can easily manage multiple motion 
axis instances. 


In the case of a motion axis instance configured as a Master Feedback, there is very little state 
information to visualize; the motion axis is in the Stand-by state called Stopped and remains in 
that state unless there is a feedback fault that transitions it to Major Faulted. A Master 
Feedback axis, therefore, has no affect on the Module Status LED unless a fault occurs, in 
which case the Module Status shows Flashing Red (Major Recoverable Fault). A Master 
Feedback axis has no affect on the Axis Status LED nor is a separate LED required for such an 
axis. 


In the case of a multiple motion axis instances, each with a separate power structure, the 
behavior of the Module Status LED is a roll-up of the states of the device axes. When the 
device axes are in disparate states, the Module Status LED condition is based on the following 
precedent. 


1. Major Unrecoverable Fault 
2. Major Recoverable Fault 
3. Standby 

4. Operational 


In other words, as far as the Module Status LED is concerned a Major Recoverable Fault on 
Axis 1 has a higher precedence than Axis 2 that is in the Standby state, Start Inhibit. Note that 
minor faults and alarms are not recognized by the Module Status LED. 


Multi-character displays easily handle multiple axis instances by adding a “”’X#” prefix to the 
display string to specify the associated motion axis instance number. For Master Feedback axis 
instances, no specific display string is shown unless the Master Axis has a fault or alarm 
condition. 


Table 5-46.81 Multi-Axis Multi-Character Alphanumeric Display Behavior 


Display String Drive Condition 

SELF-TEST Executing device Self-Test 
CONNECTING Connecting (waiting for Fwd Open) 
CONFIGURING Configuring Motion Device Attributes 
SYNCING Synchronizing (waiting for Group Sync) 
PRE-CHARGE Waiting for DC Bus Up 
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X#:SHUTDOWN 
X#:STOPPED 
X#: INHIBITED 
X#:STARTING 
X#:RUNNING 
X#:TESTING 
X#: STOPPING 
X# : ABORTING 


X#:INIT FLT S## 
X#: INIT FLT M## 


X#:FLT S## 
X#:FLT M## 
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Drive Condition 
Axis has been Shutdown 
Axis has stopped 
Axis is Start Inhibited 
Axis is Starting 
Axis is Running 
Axis is executing a Test procedure 
Decelerating to a stop as a result of a disable 
Decelerating to a stop as a result of a fault 
Initialization Fault — Std and Fault Code 
Initialization Fault - Mfg and Fault Code 
Fault — Std. and Fault Code 
Fault - Mfg and Fault Code 


X#:ALARM S## 
X#:ALARM M## 
X#: INHIBIT S## 
X#: INHIBIT M## 


Initialization Fault — Std and Fault Code 
Initialization Fault - Mfg and Fault Code 
Initialization Fault — Std and Fault Code 
Initialization Fault - Mfg and Fault Code 


X# = Axis Instance Number (0, 1, 2, 3...) > 0 = class instance 
Command Generation Behavior 
Command Data Sources 


Command data can take the form of Controller Position, Velocity, Acceleration, and Torque 
Commands. The command data element provided is specified by the Command Data Set 
attribute, which is based on the selected Control Mode. The primary command data element 
can be augmented by higher order command elements for the purposes of generating high 
quality feed-forward signals. 


Command Fine Interpolation 


For synchronized, high-performance applications using CIP Motion, command data is received 
from the CIP Motion Controller-to-Device Connection and processed by a fine interpolator. 
The job of the fine interpolator is to compute coefficients to a trajectory polynomial that is 
designed to reach the command data value at its associated Command Target Time. Depending 
on the specific command data element, the trajectory can follow a 1%, 2, or 3“ order 
polynomial trajectory with initial conditions based on current axis dynamics. Since the 
polynomial is a function of time, a new fine command value can be calculated any time the CIP 
Motion Device needs to perform a control calculation. As a result, it is not necessary that the 
device’s control calculation period be integrally divisible into the Controller Update Period. 


To improve device interchangeability, the Motion Axis Object recommends a minimum order 
for the fine interpolators. Since contemporary motion planners typically generate their 
trajectories based on 3 order polynomials in position, it is important that the fine interpolators 
reproduce these trajectories with high fidelity. Therefore, the position fine interpolator is 
defined as 3 order, the velocity interpolator is 2" order, and the acceleration and torque 
interpolators are both 1* order. 
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Position Fine Interpolation Polynomial: 

P(t) = ao + ay * (t-to) + ag * (t- to)” + a3 * (t-to)” 
Velocity Fine Interpolation Polynomial: 

V(t) = bo + by * (t+to) + by * (t- to)? 
Acceleration Fine Interpolation Polynomial: 

A(O) = Co + Cy * (t-to) 
Torque Fine Interpolation Polynomial: 

T(t) = do + dy * (t-to) 


In these equations, time tp represents the Command Target Time for the previous motion 
planner update such that when t = ty the position, velocity, acceleration, and torque command 
values are equal to the values sent in the previous motion planner update, i.e. P_;, V1, A.., and 
T_,.. This establishes the 0" order coefficients of the polynomials. 


P(to) am Py = ao 

V(to) = Vi = bo 
A(to) = A-1= Co 
T(to) ane Ty oar do 


The higher order polynomial coefficients are calculated such that by the next motion planner 
update, corresponding to Command Target Time, t,, the position, velocity, acceleration, and 
torque command values are the values sent in the latest motion planner update, i.e. Po, Vo, Ao, 
and To. 


P(ti) = Po 
V(ty) = Vo 
A(t) = Ao 
T(ty) = To 


Using the above polynomial interpolation equations, the CIP Motion device can compute 
position, velocity, acceleration, and torque command values at any time by plugging in the 
current System Time value of the CIP Motion device into the variable, t. This allows the 
device’s control calculation to be performed according to a schedule that is independent of the 
controller’s update schedule. 


One thing that must be done, however, is to adjust the Command Target Time, ty , should there 
be a shift in the System Time Offset for the device; to and t must always be based on the same 
System Time reference system. For example, assume the device’s System Time Offset when 
the control command timestamp, to, was received is Offsetg. If the command interpolation 
equation is to be applied at t = t; and the current System Time Offset is defined as Offset, then 
to must be adjusted as follows before executing the polynomial: 


Adjusted to = tp * (Offset, — Offset,) 


The polynomial coefficients are computed based on standard formulas that are a function of the 
history of command values over the last few updates. The number of historical command 
values used in the formula depends on the order of the polynomial. For example, the third order 
command position polynomial uses the three previous command position values. For 
convenience, the interpolator polynomial coefficient formula’s are as follows: 
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Position Fine Interpolation Polynomial Coefficients: 


ao = P., 

ay = 1/T * (APo — 1/2*AVo + 1/6*AAo) 
ap = 1/T? * (1/2*AVp- 1/2*AAg) 

a3 = 1/T° * (1/3*AAp) 


Velocity Fine Interpolation Polynomial Coefficients: 


bo = V4 
b; = 1/T * (AV — 1/2*AAo) 
by = 1/T? * (1/2*AAp) 


Acceleration Fine Interpolation Polynomial Coefficients (Torque is same form as Accel): 


Co = Ay 
Cc; = 1/T * AAo 


The above equations are based on the following nomenclature: 


T = Controller Update Period 

APo = (Po — Ps) 

AVo= (Vo — V1) = (Po — 2P-1+ P.2) 

AAo = (Ao — Aa) = (Vo — VP.1 + V2) = (Po- 3P1 + 3P.2+ Ps) 


Note that when t > t), the fine interpolation polynomial becomes an extrapolation polynomial. 
In the absence of a fresh update from the motion planner, the extrapolation polynomial can be 
used to provide estimated command data to the control structure until fresh motion planner 
command data is available. Once fresh command data is made available new polynomial 
coefficients must be computed without delay. In this way, the motion control can “ride-thru” 
occasional late or lost connection data packets resulting in a robust distributed motion control 
network solution. To be clear, late connection data is always applied and never thrown away; 
late data still represents the freshest data available from the controller and the extrapolation 
polynomial insures that the command data is applied in such a way as to maintain a smooth 
motion trajectory despite variations in command data delivery. 


When the update period of the motion planner is short enough relative to the dynamics of the 
command trajectory, or is comparable to the device’s control calculation period, fine 
interpolation may not be necessary. The motion planner can make this determination by 
comparing the planner update period to that of the device’s control calculation period. When 
fine interpolation is used, the planner must add additional planner update periods to the planner 
time stamp, so it is advantageous to eliminate this planner update period delay if interpolation 
is not necessary. 


Even though fine interpolation may not be necessary in some cases, it does not mean that the 
command data is to be applied directly to the control structure. It still may be necessary to 
calculate the above polynomials so the device can extrapolate the command value when the 
device’s control update occurs. That is because, in general, the device’s control update time 
stamp does not need to match the time stamp of the command data. 


Finally, there are CIP Motion device types and control modes that do not required the dynamic 
accuracy that time-stamped interpolation and extrapolation provide. Various velocity and 
torque control applications, for example, may fall in this category. In general, command data 
can also be applied to the control structures of Variable Frequency drives without interpolation 
or extrapolation. 


— 5-519 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 6 


5-46.36.3 


5-46.36.4 


5-46.36.5 


5-46.36.6 


Motion Axis Object, Class Code: 42hex 


Feed-Forward Signal Selection 


The fine interpolators defined as part of the Motion Axis Object can generate higher derivatives 
of the command data input to serve as feedforward signals. Superior signal quality, however, 
can be provided by the motion planner trajectory generators. The feedforward selection blocks 
pick the best feed-forward signal to apply based on the bits set in the Command Data Set 
attribute. The best signal is defined as the signal derived using the fewest differencing 
operations. Note that the interpolated command position is applied directly to the position 
control loop without any of the typical de-referencing and offsets. It is assumed that these 
operations are performed by the controller based motion planner. 


Velocity Limiter 


The Interpolated Velocity Command signal passes through a series of dynamic limiters that are 
commonly used for velocity control. The Velocity Limiter provides independent positive and 
negative limits for the velocity command reference that can be applied to the device’s control 
structure. 


Skip Bands 


Skip Bands are typically used in Frequency Control applications when certain speeds excite 
mechanical resonance frequencies of the motor and load. The Skip Band feature allows three 
separate Skip Speeds to be defined that shift the Interpolated Velocity Command signal to 
avoid, or skip, these problematic speeds. The Skip Speed Band determines the range of speeds 
centered on the three Skip Speeds that the device avoids. If the Interpolated Velocity Command 
falls is within the Skip Band but below the Skip Speed the Velocity Command output is set to 
the Skip Speed, minus % the Skip Speed Band. If the Interpolated Velocity Command falls is 
within the Skip Band but above the Skip Speed the Velocity Command output is set to the Skip 
Speed, plus 4 the Skip Speed Band. 


Acceleration Limiter 


The Acceleration Limiter limits the rate of change of the Velocity Command based on 
independent Acceleration and Deceleration Limits. Such a limiter is particularly valuable when 
the Interpolated Velocity Command is changed in discrete steps, such as when the motor speed 
is being controlled via a series of Controller Velocity Command set-points. The Acceleration 
Limiter turns the step changes of the Interpolated Velocity Command into controlled 
acceleration and deceleration ramps. The Acceleration Limiter can also support Jerk Limit 
Control that produces an S-Curve response to step changes in velocity command, providing 
even smoother speed transitions. The Jerk Limit Control attribute determines what percentage 
of the acceleration or deceleration ramps is S-Curve with the remaining portion of the ramp 
governed by the fixed Acceleration or Deceleration Limit. 
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Figure 5-46.32 Command Generator 
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Feedback Interface Behavior 


Feedback Sources 


Feedback signals defined by the Motion Axis Object can be derived from any of 4 different 
feedback interface channels. The two primary feedback channels employed by the various 
closed loop control modes are designated Feedback 1 and Feedback 2. This allows the control 
loops to operate with either a motor based feedback device that is typically attached to the 
Feedback 1 channel or a load-side feedback device that is connected to the Feedback 2 channel. 
Which feedback source is used by the loop is governed by the Feedback Configuration 
attribute. 


Each feedback interface is capable of supporting a number of different feedback device types 
as enumerated by the Feedback Type attribute. The feedback interface output is the number of 
feedback counts that the feedback device has moved since the last time the device was 
sampled. If the feedback device is an absolute device, the feedback interface also determines 
the absolute position of the feedback device at power-up and communicates that value to the 
Feedback Accumulator to preset the accumulator. 
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Feedback Accumulator 


The role of the Feedback Accumulator depends on the configured Feedback Mode which can 
be either Incremental or Absolute. If Incremental is selected the accumulator simply 
accumulates changes to the feedback count value, a 32-bit signed integer, with every device 
update. If Absolute is selected, the Feedback Accumulator works basically the same way as in 
Incremental mode. The only difference is the initialization of the accumulator at device power- 
up. In Incremental mode, the Feedback Accumulator is set to zero, while in Absolute mode, the 
accumulator is initialized to the absolute position of the feedback device. This allows for the 
recovery of absolute position through a power-cycle as long as power-off movement of the 
absolute feedback device is limited to % of the absolute feedback range of the device. There is 
no requirement to extend the absolute position range of the feedback device through non- 
volatile storage of the accumulator. This simple absolute feedback handling mechanism is due 
to the fact that the CIP Motion places the responsibility of extending the absolute position 
range of the axis, and establishing the absolute machine position reference, on the controller. 


Commutation Unwind and Offset 


Also connected to the Feedback 1 interface is an Electronic Unwind block. This block is 
designed to unwind, or modulo, the position accumulator output to generate a signal that is 
proportional to the electrical angle of a Permanent Magnet motor based on the based on the 
Pole Count or Pole Pitch of the motor. To align this signal with the physical UVW windings of 
the motor rather than the zero of the feedback device, a configurable Commutation Offset is 
added prior to the Electrical Unwind block. 


Feedback Filtering 


A configurable low-pass IIR filter is defined by the Motion Axis Object for filtering the 
velocity and acceleration estimates for each feedback channel. These filters can be used to 
reduce the level of quantization noise associated with differencing digital feedback signals. The 
bandwidth of the velocity and acceleration IIR filters for each feedback channel are 
individually programmable. 
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Figure 5-46.33 Feedback Channels 1 and 2 
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Figure 5-46.34 Feedback Channels 3 and 4 
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Event Capture Behavior 


Event Input Sources 


The Motion Axis Object defines a mechanism to capture both the feedback position and time 
stamp associated with specific state transitions of selected event input sources. Event input 
sources currently supported by the object are Registration 1, Registration 2, Marker, and Home 
Switch. These 4 event input sources apply to each supported feedback channel. 


Event Latches 


To facilitate accurate capture of both feedback position and time, hardware event latches are 
typically implemented as shown in the following block diagram. Note that two independent 
latches are defined for each registration input, one latch to capture positive edge transition 
events and one to capture negative edge transition events. This design enables capture of both 
registration events in applications with narrow registration pulses where the rising and falling 
edges occur nearly simultaneously. In addition to the registration latches, a separate latch is 
also defined for the home event capture. The home input event that triggers the Home Event 
Latch can be any of a number of different combinations of home switch and marker input 
events, i.e. marker transitions, switch transitions, or switch transitions followed by a marker 
transition. 


— 5-524 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 6 


Motion Axis Object, Class Code: 42hex 


With hardware based event latches, event capture accuracy is, in general, only limited by the 
latency of the associated event input. Registration and Marker event inputs are lightly filtered 
so event capture accuracy is on the order of 1 psec. In terms of position capture accuracy, that 
would be calculated as the product of the event capture accuracy and the speed of the axis. 
Home switch inputs are heavily filtered, in general, and therefore limited to an event capture 
accuracy of 1 to 10 msec. Thus, to get an accurate position capture based on a home switch 
input transition, a homing sequence with a slow homing speed is required. 


5-46.38.3 Event Time Stamps 


Since the registration time stamp is passed to the controller as part of the Event Notification 
data, the controller can apply the event time stamp to the position history of other axes in the 
system to interpolate their positions. This is particularly useful in applications where it is 
necessary to determine the location of several axes at the time of a single registration event. 
The more accurate the time stamp, the more accurately the controller can determine these 
positions. 


Figure 5-46.35 Event Capture Functionality 
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Control Mode Behavior 


The instance attributes defined in Section 5-46.7 affect device behavior in the context of the 
Control Mode, Control Method, and Feedback Configuration. As discussed in 5-46.2.1 
concerning the scope of the Motion Axis Object, there are basically 4 Control Modes common 
to CIP Motion devices, position control, velocity control, torque control, and no control. To 
this list we add a new control mode, acceleration control, to complete the progression from 
velocity control to torque control. This section provides a block diagram for each of the control 
modes in an effort to further define the collective behavior of the various Motion Axis Object 
attributes. 


No Control (Feedback Only) Mode 


A Motion Axis Object instance can be configured for No Control mode to allow for the 
position, velocity, and acceleration of any one of four possible feedback channels to be 
accessed by the controller via the Device-to-Controller Connection. These signals can then be 
distributed across the motion control system as a master axis for gearing and camming 
operations. In this mode, the Feedback Configuration attribute determines which feedback 
channel produces the Position, Velocity, and Acceleration Feedback signals. 


Figure 5-46.36 No Control (Feedback Only) 
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Position Control Mode 


In Position Control mode, the only operative Control Method supported by the object currently 
is Closed Loop servo control. At a later date the object could be expanded to include a Stepper 
based position Control Method. 


Closed Loop Position Control 


When performing closed loop position control, the CIP Motion device applies the Position 
Command signal output of the Command Generator to the position loop-summing junction. In 
addition to the Position Command, a Position Trim input is provided which can be used to 
provide an offset to the position loop. The classic PI control loop generates a Position Loop 
Output signal to an inner velocity loop. 


Position Feedback Configuration 


Feedback to the PI regulator can be derived from two different feedback channels. This 
flexibility allows the position loop to operate with either a motor-based feedback device that is 
typically attached to the Feedback 1 channel or a load-side feedback device that is connected to 
the Feedback 2 channel. Which feedback source is used by the loop is governed by the 
Feedback Configuration attribute. 


When the Feedback Configuration calls for Dual Feedback operation, the position loop utilizes 
the Feedback 2 channel and the velocity loop uses the Feedback 1 channel. Since the two 
feedback channels may not have the same feedback resolution, it is necessary to convert 
position loop output from Feedback 1 counts to Feedback 2 counts prior to applying the output 
to the velocity loop summing junction. This is done scaling the position loop output by the 
Feedback 1/2 Count Ratio. 


Position PI Gains 


The Proportional Gain of the classic PI controller sets the unity gain bandwidth of the position 
loop in radians/sec, while the Integral Gain is used to drive the Position Error signal to zero to 
compensate for the effect of any static and quasi-static torque or forces applied to the load. 


Velocity Feed-Forward 


The inner velocity loop requires a non-zero command input to generate steady-state axis motor 
velocity. To provide the non-zero output from the CIP Motion device to the motor, a non-zero 
position loop output is required, which translates to a non-zero position error. This dynamic 
error between command position and actual position while moving is often called “following 
error”. Most closed loop motion control applications desire zero following error -- all the time! 
This could be achieved to some extent through use of the position integral gain control as 
described above, but typically the response time of the integrator action is too slow to be 
effective in high-performance motion control applications. An alternative approach that has 
superior dynamic response is to use Velocity Feedforward. 
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The Velocity Feedforward feature is used in Position Control mode to provide the bulk of the 
Velocity Reference input necessary to generate the desired motor velocity. It does this by 
scaling the Velocity Feed-forward Command signal output of the Command Generator by the 
Velocity Feedforward Gain and adding to the Position Loop Output generated by the position 
loop to form the Velocity Reference signal. With this feature, the position loop does not need to 
generate much effort to produce the required velocity command level; hence the Position Error 
value is significantly reduced. The Velocity Feedforward Gain allows the following error of the 
position control loop to be reduced to nearly zero when running at a constant velocity. This is 
important in applications such as electronic gearing and synchronization applications where it 
is necessary that the actual axis position not significantly lag behind the commanded position at 
any time 


The optimal value for Velocity Feedforward Gain is 100% theoretically. In reality, however, 
the value may need to be tweaked to accommodate velocity loops with finite loop gain. One 
thing that may force a smaller Velocity Feedforward value is that increasing amounts of 
feedforward tends to exacerbate axis overshoot. For this reason feed-forward is not 
recommended for point-to-point positioning applications. 


Figure 5-46.37 Closed Loop Position Control 
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Velocity Control Mode 


In Velocity Control mode, there are two operative control methods supported by the object, 
Closed Loop Velocity Control and Open Loop Frequency Control. 
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Closed Loop Velocity Control 


The Closed Loop velocity control method is targeted for applications that require tight speed 
regulation. Note that the command input to the velocity loop can be derived directly from the 
Velocity Command of the Command Generator when configured for Velocity Control Mode or 
from the Position Loop Output when configured for Position Control Mode as described in the 
previous section. 


When serving as an outer velocity loop in Velocity Control Mode, the device applies the 
Velocity Command input to the velocity-summing junction as the Velocity Reference of a 
classic PI regulator. Also contributing to the Velocity Reference input signal is the Velocity 
Trim input, which can be used in conjunction with an outer control loop to make minor 
adjustments to the velocity of the motor. 


When serving as an inner velocity loop in Position Control Mode, the device applies the 
Position Loop Output signal to the input of the velocity-summing junction. Input signals that 
are not applicable to the configured control mode are generally set to zero. 


Velocity Feedback Configuration 


Feedback to the PI regulator can be derived from either of the two available feedback 
transducers, Feedback 1 or Feedback 2. Which feedback source is used by the loop is governed 
by the Feedback Configuration enumeration. 


Velocity Error Filter 


A low pass filter can be optionally applied to the velocity error signal generated by velocity 
loop summing junction. The output of this filter becomes the Velocity Error signal that is 
subsequently operated on by the velocity loop PI control algorithm. When used, the filter is 
typically set between 5 to 10 times the velocity loop bandwidth. It is recommended that this 
filter be a two pole IIR filter to maximum its effectiveness at quantization noise filtering. 


Velocity PI Gains 


The velocity loop generates a Velocity Loop Output signal to the next inner loop via a classic 
PI control loop structure. The Proportional Gain of the controller sets the unity gain bandwidth 
of the velocity loop in radians/sec, while the Integral Gain is used to drive the Velocity Error 
signal to zero to compensate for any static and quasi-static torque or forces applied to the load. 


The integral section of the velocity regulator includes an anti-windup feature. The anti-windup 
feature automatically holds the regulator’s integral term when a limit condition is reached in 
the forward path. The anti-windup feature is conditioned by the arithmetic sign of the 
integrator’s input. The integrator is held when the input’s sign is such that the integrator output 
moves further into the active limit. In other words, the integrator is allowed to operate (not 
held) when the input would tend to bring the integrator output value off the active limit. 


The integrator may also be configured for integrator hold operation. When the Integrator Hold 
attribute is set true, the regulator holds the integrator from accumulating while the axis is being 
commanded to move. This behavior is helpful in point-to-point positioning applications. 


An automatic preset feature of the velocity regulator’s integral term occurs when a transition is 
made from a torque control mode to speed control mode, using the Control Mode selection 
parameter. Upon transition to speed mode, the speed regulator’s integral term is preset to the 
motor torque reference parameter. If the speed error is small, this provides a ‘bumpless’ 
transition from the last torque reference value present just prior to entering speed mode. 


— 5-529 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


5-46.44.4 


5-46.44.5 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 6 


Motion Axis Object, Class Code: 42hex 
Velocity Droop 


Another feature of the velocity regulator is the velocity droop function. The velocity error 
input to the integral term is reduced by a fraction of the velocity regulator’s output, as 
controlled by the droop gain setting, Kdr. As torque loading on the motor is increased, actual 
motor speed is reduced in proportion to the droop gain. This is helpful when some level of 
compliance is required due to rigid mechanical coupling between two motors. 


Acceleration Feed-Forward 


The velocity loop requires a non-zero velocity loop output to generate steady-state axis motor 
acceleration. To provide the non-zero output from the drive device to the motor, a non-zero 
velocity error is generally required. In position control applications this non-zero velocity error 
translates to a non-zero position loop error. Since many closed loop motion control applications 
require near zero control loop error, this behavior is not desirable. Again, the position and 
velocity loop error could be reduced by applying the velocity integral gain control as described 
above, but the integrator action is still too slow to be very effective. The preferred approach 
with superior dynamic response is to use Acceleration Feedforward. 


The Acceleration Feed-forward Gain attribute is used to generate the output necessary to 
generate the commanded acceleration. It does this by scaling the Acceleration Feed-forward 
Command generated by the Command Generator by the Acceleration Feedforward Gain and 
adding it as an offset to the output of the velocity loop. With this feature, the velocity loop does 
not need to generate much control effort, thus reducing the amount of control loop error. 


The optimal value for Acceleration Feedforward is 100% theoretically. In reality, however, the 
value may need to be tweaked to accommodate variations in load inertia and the torque 
constant of the motor. Like Velocity Feedforward, Acceleration Feedforward can result in 
overshoot behavior and therefore should not be used in point-to-point positioning applications. 


When used in conjunction with the Velocity Feedforward, the Acceleration Feedforward allows 
the following error of the position or velocity control loop to be reduced to nearly zero during 
the acceleration and deceleration phases of motion. This is important in tracking applications 
that use electronic gearing and camming operations to precisely synchronize a slave axis to the 
movements of a master axis. 
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Figure 5-46.38 Closed Loop Velocity Control 
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Open Loop Frequency Control 


Another Velocity Control method is the open loop Frequency Control method associated with 
so called Volts/Hertz or Variable Frequency Drives (VFDs) that do not have a current control 
loop and typically drive an induction motor. Velocity control with this method is achieved by 
controlling the voltage and frequency output of the drive device in some manor where voltage 
is generally proportional to frequency. For an induction motor, the velocity of the motor is 
determined by the Output Frequency of the drive drive device divided by the Motor Pole count. 
This control method is applicable to velocity control applications that do not require tight speed 
regulation and therefore do not require a feedback device. The following block diagram 
illustrates this open loop velocity control method. 


Basic Volts/Hertz Operation 


The Motion Axis Object provides a number attributes that are used to specify the relationship 
the CIP Motion device uses between output frequency (speed) and output voltage for a given 
(induction) motor. The Break Frequency and Break Voltage attributes define the point on the 
Volts/Hertz curve below which the Start Boost feature is applied. As the name indicates, Start 
Boost is used to provide a non-zero output voltage to the motor at standstill to assist start-up. 
The contribution of the Start Boost to the output voltage of the drive device tapers off to zero 
when the motor reaches the Break Frequency. Above the break point, output voltage and output 
frequency follow a linear slope to the point defined by the Motor Rated Frequency and Motor 
Rated Voltage. From this point on, the Volts/Hertz curve follows another linear slope to the 
point defined by the Max Frequency and Max Voltage attributes. This segment of the 
Volts/Hertz curve allows for operation above the rated frequency and voltage of the motor in 
applications where that is required. 
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5-46.45.2 Slip Compensation 


When driving an induction motor at a specific frequency, the actual motor velocity is generally 
less than the command speed, given by the output frequency divided by the motor pole count, 
by an amount that is proportional to the load torque applied to the motor. This difference in 
speed is called “Slip” and is a configuration attribute associated with the motor. The Motion 
Axis Object supports a Slip Compensation feature that is common to Variable Frequency 
Drives. The amount of Slip Compensation applied to the Velocity Reference is the product of 
the measured torque producing current, Iq, and the configured Rated Slip Speed 


5-46.45.3 Velocity Droop 


Another feature defined for the Frequency Control method is the droop function. The droop 
function reduces the velocity reference by a scaled fraction of the torque producing current, Iq, 
as controlled by the droop gain setting, Kdr. As torque loading on the motor is increased, 
actual motor speed is reduced in proportion to the droop gain. This is helpful when some level 
of compliance is required when performing torque sharing between two motors on a common 
load. 


Figure 5-46.39 Open Loop Frequency Control 


Max Voltage 


Control Method 
Motor Rated Voltage 
Motor Rated Frequency 


Motor Volts 


o Max Voltage 
2 Max Frequency 
= Start Boost 
S Run Boost 
Break Voltage 
Break Frequency 
Stator Resistance 
Break Volts Leakage Inductance 
Motor Flux Current 
Start Boost 
Break Motor Max ViHz Conv -}————_> Paria 
Frequency Frequency Frequency 9 
Frequency 
Bus Reg Mode 
Velocity Overspeed Limit 
Trim +/- Peak Current Limit 
Motor Poles/2 
Velocity 
Reference 


Output 
|__» P' 


Frequency 


Velocity 
Command e (2) “(z) 
- + 


Frequency 
Reference 


DC Bus 
Voltage 


Rated Slip Speed 


Slip 
Compensation 


. 'q 
SlipComp }——_——_———_® Feedback 


Iq 
Feedback 


— 5-532 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 6 


5-46.46 


5-46.47 


5-46.47.1 


5-46.47.2 


Motion Axis Object, Class Code: 42hex 
Acceleration Control Mode 


While dynamic motor control via an acceleration command is not common in the industry, 
Acceleration Control was added to the Motion Axis Object to complete the dynamic 
progression from velocity control to torque control. The output of the velocity loop, Velocity 
Loop Output, also has units of acceleration. So, like the other control modes we sum the 
contributions of the Acceleration Command, Acceleration Trim, and Velocity Loop Output to 
form the Acceleration Reference signal that serves as one of the primary inputs to the Torque 
Control section. 


Figure 5-46.40 Acceleration Control 
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Torque is generally proportional to acceleration and to the torque producing motor current, Iq. 
The purpose of the Torque Control structure is to combine input signals to create a Torque 
Reference from a number of different sources based on the Control Mode and apply various 
filters and compensation algorithms to the Torque Reference to create a Filtered Torque 
Reference. The Filtered Torque Reference signal is scaled by the torque constant of the motor 
to become the Current Command input to the current loop. Since the motor current is also per 
unitized to the % Rated current of the motor, the torque constant, Kt, is nominally 1. 


Torque Input Sources 


The Torque Control section can take input from a variety of sources depending on the Control 
Mode. Input to the Torque Reference path can come via the cyclic Torque Command or Torque 
Trim signal in Torque Control mode. In Position or Velocity Control mode, torque input can 
also be derived from the outer velocity loop by bringing in the Velocity Loop Output into the 
torque loop-summing junction. In Acceleration Control Mode, the Acceleration Reference 
signal is applied representing the sum of the cyclic Acceleration Command and Acceleration 
Trim data. 


Torque Scaling 


Since the Velocity Loop Output and Acceleration related values have units of acceleration, 
these values are multiplied by a Torque Scaling gain, Kj, to convert to “per unitized” torque. 
The torque units defined by the Motion Axis Object are expressed as % of Rated Torque of the 
motor. The Torque Scaling gain, when properly configured, represents the total inertia or mass 
of the system that includes the motor and the load. 
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Low Pass Filter 


The Low Pass Filter is effective in resonance control when the natural resonance frequency is 
much higher (>5x) than the control loop bandwidth. This filter works by reducing the amount 
of high-frequency energy in the output signal that excites the natural resonance. The Low Pass 
Filter design can be single pole or multiple poles. Care must be taken, however, to limit the 
amount of phase lag introduced by this filter to the control loop to avoid potential instability. 


Notch Filter 


The notch filters is effective in resonance control when the natural resonance frequency is 
higher than the control loop bandwidth. Like the Low Pass filter, the notch filter works by 
significantly reducing the amount of energy in the output signal that can excite the natural 
resonance. It can be used even when the natural resonance frequency is relatively close to the 
control loop bandwidth. That is because the phase lag introduced by the notch filter is localized 
around the notch frequency. For the notch filter to be effective, the Notch Frequency has to be 
set very close to the natural resonance frequency of the load. 


A typical equation for the notch filter is as follows: 


s42 + wn’r2 
G(S) = ------------------02 2222-222 22-2 2-- 
s42 +s * wn/Q + wnr2 


In this equation, Q represents the sharpness of the notch. In most implementations, the 
sharpness, Q, is typically hard-coded. The attenuation depth of the notch filter is infinite. 


Torque Limiter 


The Filtered Torque Reference signal passes through a limiter block to produce the Limited 
Torque Reference signal. The Torque Limiter block applies a torque limit to the signal that is 
based on the sign of the torque reference signal input and the state of the axis. During normal 
operation it is the Torque Limit — Positive and Torque Limit — Negative attributes, set by the 
user, is applied to the torque reference signal. When the axis is commanded to stop as part of a 
disable request or major fault condition the device applies the Stopping Torque Limit. 


Also included with the torque limit block is a built in Torque Rate of Change Limit. This 
feature limits the rate of change of the torque reference output. 


Figure 5-46.41 Torque Control 
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Current Control Mode 


In general, motor torque is controlled by controlling the orientation and magnitude of the motor 
stator current vector with respect to the rotor magnetic flux vector. The Current Control loop is 
responsible for providing this control and is actually composed of two PI loops, one that 
controls the torque producing current, Iq, and one that controls the flux producing current, Id. It 
is the quadrature component of current, Iq, that is used for dynamic torque control. 


In the case of an induction motor, the flux producing current, Id, is solely responsible for 
generating rotor flux. In the case of permanent magnet motors, rotor flux is generated by the 
rotor magnets and Id is only used to in some cases to extend the speed range of the motor by 
changing the angle of stator field relative to the rotor field. In this case, the angle of Iq relative 
to the rotor field remains the same, i.e. at quadrature. But since the vector combination of Iq 
and Id determines the stator flux angle relative to the rotor, increasing amounts of Id can shift 
the stator flux away from quadrature to extend the speed range of the motor at the expense of 
torque. 


Current Vector Limiter 


The Iq Current Command passes through a Current Vector Limiter block before becoming the 
Iq Current Reference signal. This limiter block computes the combined vector magnitude of the 
Iq Current Command and the Id Current Reference signals. The resultant current vector 
magnitude is compared to the Operative Current Limit that represents the minimum current 
limit from among a set of potential current limits of the drive device and motor. If the vector 
magnitude exceeds the Operative Current Limit, the Iq Current Command is reduced so the 
vector magnitude equals the Operative Current Limit. Potential current limit sources can be the 
Peak Current Limit ratings as well as the Thermal Limits for the Motor and Drive Inverter. 
Some of these limits are conditional and dynamic, such as the Motor and Inverter Thermal 
Current Limits derived from the thermal models for these devices. These limits are only active 
when the corresponding Motor and Inverter Overload Action attributes are set to provide 
current fold-back. The thermal current limits in this case would decrease as the simulated 
temperature of the modeled devices increases. The Bus Regulator Limit is only applied when 
the motor is regenerating power onto the DC Bus and is based on the Bus Regulator Power 
Limit. 

With all these potential current limit sources that could be operative, a Current Limit Source 
attributes was included with the Motion Axis Object to identify the source of the active current 
limit. 

Voltage Output 


The output of each current loop is scaled by the motor inductance to generate a voltage 
command to the vector transformation block. It is the job of the vector transformation block to 
transform the torque producing, Vq, and flux producing, Vd, command signals from the 
rotating synchronous reference frame to the stationary stator reference frame. The resultant U, 
V, and W Output Voltage values are then applied to the motor by Pulse Width Modulation 
(PWM). The PWM Frequency is also a configurable attribute of the Motion Axis Object. 


The magnitude of the Vq, Vd vector is calculated in real time as the total Output Voltage 
signal. The maximum Output Voltage signal that can be applied to the motor is ultimately 
limited by the DC Bus Voltage and enforced by the Voltage Vector Limiter. Any attempt to 
exceed this value results in an Inverter Voltage Limit condition. 
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5-46.48.3. Current Feedback 


Current feedback signals to the current loop are provided by two or three current sensors. The 
signals from these sensors are conditioned and corrected for device specific offsets to become 
the U, V, and W Current Feedback signals associated with the stationary motor stator frame. 
These three signals are transformed back to the synchronous reference frame to generate the Iq 
and Id Current Feedback signals. The magnitude of the Iq, Id current vector is calculated in 
real-time and used as an input to the thermal models for the inverter and motor. 


5-46.48.4 Motor Commutation 


Motor commutation is critical to closed loop motor control. The orientation of the motor rotor 
can be determined from a feedback source mounted to the motor. The actual commutation 
source is the motor feedback device assigned to Feedback 1. Once the feedback device is 
calibrated to the absolute orientation of the rotor using the Commutation Offset attribute, the 
commutation block can then generate the true Electrical Angle of the rotor. This signal is used 
to perform the vector transforms between the rotary and stationary motor frames and can also 
be used for any other algorithms that require knowledge of rotor position. 


Figure 5-46.42 Closed Loop Current Vector Control 
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Definition of Motion Terms 


Axis - logical element of a motion control system that exhibits some form of movement. Axes 
can be rotary or linear, physical or virtual, controlled or simply observed. A physical axis may 
include one or more of the following components, a motion sensor, a motion control structure, 
a power amplifier, and a motion actuator. 


Motion — refers to any aspect the dynamics of an axis. In the context of this document it is not 
limited to servo drives but encompasses all forms of drive based motor control. 


Drive — a device designed to control the dynamics of a motor. 


CIP Motion — defines extensions to CIP objects and device profiles to support motion control 
over CIP networks. 


CIP Sync — defines extensions to CIP objects and device profiles to support time 
synchronization over CIP Networks. 


CIP Motion I/O Connection — name given to the periodic bi-directional, Class 1, CIP 
connection between a controller and a drive that is defined as part of the CIP Motion standard. 


CIP Motion Peer Connection — name given to the periodic multicast, producer/consumer, CIP 
connection between peer devices in a motion control system that is defined as part of the CIP 
Motion standard. 


CIP Motion Drive — refers to any drive that complies with the CIP Motion standard. 


Variable Frequency Drive (VFD) — name given to a class of drive products that seek to 
control the speed of a motor, typically an induction motor, through a proportional relationship 
between drive output voltage and commanded output frequency. Frequency drives are, 
therefore, sometimes referred to as a Volts/Hertz drives. 


Vector Drive — name given to a class of drive products that seek to control the dynamics of a 
motor via closed loop control which includes, but is not limited to, closed loop control of both 
torque and flux vector components of motor stator current relative to the rotor flux vector. 


Closed Loop — refers to methods of control where there is a feedback signal of some kind that 
is used to drive the actual dynamics of the motor to match the commanded dynamics by servo 
action. In most cases there is a literal feedback device to provide this signal, but in some cases 
the signal is derived from the motor excitation (i.e. sensorless operation). 


Open Loop - refers to methods of control where there is no application of feedback to force 
the actual motor dynamics to match the commanded dynamics. Examples of open loop control 
are stepper drives and variable frequency drives. 


CIP Motion Drive Profile — collection of objects used to implement a CIP Motion Drive 
device that includes the Motion Axis Object, as well as standard support objects like the 
Identity Object and the CIP Sync Object. 


Motion Axis Object — describes an object that defines the attributes, services, and behavior of 
a motion device based axis according to the CIP Motion standard. 


Motion Control Axis Object — describes an object that defines the attributes, services, and 
behavior of a controller based axis according to the CIP Motion standard. 


System Time — absolute time value as defined in CIP Sync standard in the context of a 
distributed time system where all devices have a local clock that is synchronized with a 
common master clock. In the context of CIP Motion, System Time is a 64-bit integer value in 
units of nanoseconds with a value of 0 corresponding to January 1, 1970. 
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Set-point — in the context of a device, a value sent to the drive that is used to directly control 
some aspect of the motor dynamics, which includes (but not limited to) position, velocity, 
acceleration, and torque. 


Inverter — a device that generally converts DC input to AC output. An Inverter is also 
commonly called the Drive Amplifier. In the context of a drive system, the Inverter is 
responsible for controlling the application of DC Bus power to an AC motor. 


Converter — a device that generally converts AC input to DC output. A Converter is also 
commonly called the Drive Power Supply. In the context of a drive system, the Converter is 
responsible for converting AC Main input into DC Bus power. 


Shunt Regulator — refers to a specific Bus Regulator method that switches the DC Bus across 
a power dissipating resistor to dissipate the regenerative power of a decelerating motor. 


Bus Regulator — refers to any method used to limit the rise in DC Bus voltage level that occurs 
when decelerating a motor. 


Thermal Model - refers to any algorithm that attempts to model the thermal behavior of the 
associated device during operation. 


Get/Read — operation that involves the retrieving an attribute value from the perspective of 
Controller side of the interface. 


Set/Write — operation that involves the setting an attribute to a specified value from the 
perspective of Controller side of the interface. 


Cyclic Data Block — refers to high priority real-time data block that is transferred by a CIP 
Motion connection on a periodic basis. 


Event Data Block — refers to medium priority real-time data block that is transferred by a CIP 
Motion connection only after a specified event occurs. Registration and marker input 
transitions are typical drive events. 


Service Data Block - lower priority real-time data block associated with a service message 
from the controller that is transferred by a CIP Motion connection on a periodic basis. Service 
data includes service request messages to access Motion Axis Object attributes or perform 
various drive diagnostics. 


Synchronized - condition where the local clock value on the drive is locked onto the master 
clock of the distributed System Time. When synchronized, the drive and controller devices may 
utilize time stamps associated with CIP Motion connection data. 


Time Stamp — refers to System Time Stamp value associated with the CIP Motion connection 
data that conveys the absolute time when the associated data was captured or can be also used 
to determine when associated data is to be applied. 


Time Offset — refers to System Time Offset value associated with the CIP Motion connection 
data that is associated with source device. The System Time Offset is a 64-bit offset value that 
is added to a device’s local clock to generate System Time for that device. 
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Time Sync Object 
Class Code: 43hex 
CIP Sync Overview 


CIP Sync is the name given to the time synchronization technology for the Common Industrial 
Protocol (CIP). This technology will allow accurate real-time synchronization of devices and 
controllers connected over CIP networks that require time stamping, sequence of events 
recording, distributed motion control, and support for highly distributed applications requiring 
increased control coordination. 


CIP Sync is based on the IEEE 1588 (IEC 61588) standard — Precision Clock Synchronization 
Protocol for Networked Measurement and Control Systems, commonly referred to as the 
Precision Time Protocol (PTP). The standard is designed for, but not limited to, local area 
networks like Ethernet. The protocol provides a standard mechanism to synchronize clocks 
across a network of distributed devices. 


CIP Sync defines the Time Sync Object. The Time Sync Object provides a CIP interface to the 
IEEE 1588 (IEC 61588) Standard. 


Definitions 


Boundary clock: A boundary clock is a clock with more than a single PTP port, with each PTP 
port providing access to a separate PTP communication path. Boundary clocks are used to 
eliminate fluctuations produced by routers and similar network elements. 


Clock: A device providing a measurement of the passage of time since a defined epoch. There 
are two types of clocks in 1588: boundary clocks and ordinary clocks. 


Epoch: The reference time defining the origin of a time scale is termed the epoch. 


Grandmaster clock: Within a collection of 1588 clocks one clock, the grandmaster clock, 
will serve as the primary source of time to which all others are ultimately synchronized. 


Master clock: A system of 1588 clocks may be segmented into regions separated by boundary 
clocks. Within each region there will be a single clock, the master clock, serving as the primary 
source of time. These master clocks will in turn synchronize to other master clocks and 
ultimately to the grandmaster clock. 


Ordinary clock: An ordinary clock is a 1588 clock with a single PTP port. 


PTP: PTP is an acronym for Precision Time Protocol, the name used in the standard for the 
protocol. 


PTP message: There are five designated messages types defined by 1588: Sync, Delay_Req, 
Follow-up, Delay_Resp, and Management. 


PTP port: A PTP port is the logical access point for 1588 communications to the clock 
containing the port. 


Synchronized clocks: Two clocks are synchronized to a specified uncertainty if they have the 
same epoch and measurements of any time interval by both clocks differ by no more than the 
specified uncertainty. The timestamps generated by two synchronized clocks for the same event 
will differ by no more than the specified uncertainty. 
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System Time — absolute time value as defined by CIP Sync in the context of a distributed time 
system where all devices have a local clock that is synchronized with a common master clock. 
System Time is a 64-bit integer value in units of nanoseconds or microseconds with a value of 
0 corresponding to an epoch of January 1, 1970. 


Overview of the Precision Time Protocol (PTP) 


From the 1588 specification: “The IEEE 1588 standard specifies a protocol to synchronize 
independent clocks running on separate nodes of a distributed measurement and control system 
to a high degree of accuracy and precision. The clocks communicate with each other over a 
communication network. In its basic form, the protocol is intended to be administration free. 
The protocol generates a master slave relationship among the clocks in the system. Within a 
given subnet of a network there will be a single master clock. All clocks ultimately derive their 
time from a clock known as the grandmaster clock. The communication path between any 
clock and its grandmaster clock is part of a minimum spanning tree.” 


A PTP system of distributed clocks consists of ordinary clocks and boundary clocks. A 
boundary clock is a clock with a clock port for each of two or more distinct communication 
paths. For example a switch that implements the PTP protocol on each of its ports is a 
boundary clock. 


One clock on each subnet in the system is selected as the master clock. The selection of a 
master is made by each of the other clocks by examining information contained in special 
timing messages called Sync messages. A sync message is sent periodically by any port 
claiming to be the master clock. All ports use the same algorithm, termed the Best Master 
Clock Algorithm (BMCA). If a port of a master clock receives a Sync message from a better 
clock then that port will cease to claim to be a master and the receiving port will assume the 
status of a slave. Likewise if a clock with a port acting as a slave determines that it would make 
a better master than the current master clock or if there is no current master clock, it assumes 
the status of master and begins to send Sync messages. Some nodes may be implemented as 
slave only and will never assume mastership (e.g. an I/O device). 


An example configuration is pictured in Figure 5-47.1. A system will typically consist of one or 
more devices capable of becoming a master clock (i.e. controllers, standalone and integrated 
GPS or NTP time keepers), slave only clocks (i.e. I/O), and other devices that may or may not 
support time synchronization (switches, I/O, etc.). 
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Figure 5-47.1 Example System with Grandmaster, Boundary, and Slave Clocks 
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The starting date/time for CIP Sync System Time is 12:00 a.m., January 1, 1970. This is the 
starting epoch for both PTP and System Time. System Time is represented as a 64-bit value 
(LINT) in nanoseconds or microseconds. System Time is adjusted for leap seconds, but not 
local time zones or daylight savings time. It represents the current time at the Oth meridian. A 
negative System Time represents a time prior to the starting date/time. 


In the Precision Time Protocol, time is distributed as a structure of type “TimeRepresentation”. 
This structure is made up of two 32-bit members. The first member of the structure represents 
the number of seconds since the beginning of the epoch (January 1, 1970 0::00::00). The 
second member represents the number of nanoseconds. Leap seconds are distributed by the 
Precision Time Protocol as the current_utc_offset field. 


PTP time and leap seconds are converted to microseconds or nanoseconds to give System Time 


as: 


SystemTime = PTPTime - LeapSeconds 


CIP Sync Implementation 


Each node on the CIP network interested in clock synchronization will contain an 


implementation of a PTP clock as well as an implementation of the PTP software protocol 


stack. 
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PTP Clock Implementation 


A PTP clock can be implemented using a hardware assist circuit or with software using a free 
running timer. The choice of whether to implement a hardware assist clock or a software clock 
will depend on cost and accuracy considerations. The hardware assist circuit will generally 
result in a more accurate clock usually in the sub-microsecond range while a software 
implemented clock will yield accuracy in the tens of microseconds range. The 1588 
specification does not describe the clock implementation, but does contain guidelines and 
requirements. 


PTP Protocol Stack Implementation 


The PTP protocol stack implementation contains the software that implements the 1588 PTP 
protocol. This includes the messaging between clocks to synchronize slave clocks to master 
clocks, the algorithms to process message timestamps and tune the clock, and the management 
message support required for clock administration. The implementation of the basic protocol is 
straightforward. 


CIP Sync Clock Model 


CIP Sync defines an offset clock model to address the requirements for industrial control 
applications. This model is needed because, even though the 1588 PTP protocol defines a 
mechanism for distributing and synchronizing time, it does not define a mechanism to 
compensate for step changes in time that may occur at the grandmaster clock source. These 
changes may occur due to one or more of the following conditions: 


1. The user adjusts the master clock whose type is “HAND” set. 


2. A master with a more accurate clock becomes available (new grandmaster). This may 
occur during system startup or after the system has been running for some time. 


3. The time master is temporarily disconnected from the slave clock and then re-connected. In 
this situation, given any discrepancy in time between the master and the slave, a step 
change will occur. 


Those applications requiring a stable clock in the presence of step changes in time should 
implement their PTP clock as a local clock, synchronized to the PTP master frequency, but not 
to the PTP master’s absolute time value. 


In this model, the PTP protocol is used to discipline the local clock so that it ticks at the same 
rate as the master. The device then maintains an offset between the local clock time and system 
time. A small delta change in time will cause the device to make a small adjustment to the 
offset and to continue to “tune” its clock. A large change in time will cause the device to update 
its offset but not “tune” its clock. 


Cyclic events may then be scheduled based on the local clock and will not be affected by large 
step changes in time -- provided that the local clock remains synchronized to the PTP master 
clock frequency. 


Figure 5-47.2 shows the relationship between the Local Clock, System Time Offset, and the 
System Time for a PTP Time Slave. The “system to local clock offset” is a memory variable 
maintained by the PTP clock implementation to make offset adjustments. A leap second value 
is added to the offset to give System Time in terms of the proper epoch. 
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Figure 5-47.2 CIP Sync Offset Clock Model 
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Figure 5-47.3 shows a system of devices each implementing the CIP Sync Offset Clock Model. 
Each device is a part of a network of devices that share the same concept of System Time. Each 
device also has a Local Clock value based on a frequency-disciplined timer and related to 
System Time via an offset value (System Time Offset). Such a system allows each device to 
maintain a local time independent from all other devices, but share a common notion of system 
time. As such, System Time may change without requiring changes to the local clock. 


Figure 5-47.3 CIP Sync System with Offset Clock Model 
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CIP Sync System Time Compensation 


An application creates a timestamp by reading the clock that has been synchronized by PTP 
and making any required adjustments to the value, for example, converting it to System Time. 
Additional adjustments may be required if a step has occurred in System Time. 


CIP Sync defines a mechanism to maintain a consistent set of timestamps in the presence of 
step changes to System Time. A step change in System Time effectively causes a shift in the 
time base of the system. Any step changes to the grandmaster clock time must propagate 
through the system. Since, all nodes in the system will not see the step change at the same time, 
a timestamp taken on one node may be inconsistent with a timestamp on another node. Or a 
timestamp taken at one instance in time may be inconsistent with a timestamp taken later in 
time on the same node. A compensation algorithm is needed to make timestamps consistent 
with each other before they are used in computations. 


Two possible algorithms are described in the following section. 
The decision to compensate timestamps is made based on the requirements of the application. 
Step Compensation Algorithms 


An offset value is maintained with each timestamp. This offset value is the System Time Offset 
at the time the timestamp is captured. The offset can be used to provide an indication of when a 
step occurs in System Time. If the timestamp is transmitted across the network from one node 
to a second node the offset is sent along with the timestamp. If the two timestamps are captured 
within the same node, the offsets are stored along with the timestamps. 


The algorithms transform a timestamp from one time base to a second time base if a time base 
change occurs between the time the two timestamps are captured. When the two timestamps 
are compared they will reference the same time base. These algorithms may equally be applied 
to a set of timestamps. 


Compensation Algorithm for Timestamps Within a Single Node 


This algorithm is defined to allow a node to adjust the value of one or more timestamps that 
have been captured on the local node. 


The algorithm is stated as follows: 
Timestampc = Timestampy + Offset, — Offset 
Where, 
Timestampc is the compensated timestamp 
Timestamp is the timestamp to be compensated 
Offset; is the offset associated with the timestamp at the target time base 
Offset is the offset for the timestamp to be compensated 


The example in the following table compares two timestamps T1 and T2. At time T2 a step of 
1000 occurs. The timestamp at T1 is adjust to 1200 to be consistent with T2 for comparison. 
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Figure 5-47.4 Example: Compensated Timestamp on a Single Node 


Index Timestamp Offset Compensate Timestamp at time T1 


TO 100 0 Timestampyr1) = Timestampcr1 + 


Offset;r2) = Offset;ri) 


Tl 200 0 Timestampcri) = 200 + 1000 — 0 = 1200 


T2 1300 1000 


T3 1400 1000 


5-47.7.1.2 Compensation Algorithm for Timestamps between Nodes 


This algorithm is defined to allow a node to adjust the value of a received timestamp from a 
remote source node so that it can be compared to a timestamp on its own node, the destination 
node. 


The destination node must be able to detect a step change to the System Time on the remote 
node or on its own node and make the appropriate adjustment. Two conditions are possible: 


1. The source device has seen a step change in time but the destination device has not or 
2. The destination device has seen a step change in time but the source device has not. 


The step change is detected by a change in the SystemTimeOffset by either the source or 
destination. The source offset is sent to the destination device along with the timestamp. The 
destination device compares the offset received to the previously received offset to determine if 
a step change has occurred and adjusts the received timestamp value accordingly. 


The algorithm is stated as follows: 


TimestaMpcompensated = TimestamPpreceived + ((Destofiset i Dest astoftset) = (Source offset — 
SOUFCELastoftset)) 


Where: 
TimestamPreceivea is received timestamp. 
Destortser is the current value of the local clock time offset at the destination. 
Destzastotfset is the previous value of the local clock time offset at the destination. 
Sourceosrset is the received value of the local clock time offset from the source. 
Source astoffset 1s the previous value of the local clock time offset from the source. 
Last offsets are updated when: 
|(Destoftset — DeStpastottser) — (SOUrCE offset — SOUFCELastoftset)| <= SyncBoundsLimit 
Where: 


SyncBoundsLimit is a relatively small number that defines that synchronization bounds for the 
application. 


The example in the following table compares two timestamps between nodes after a system 
time step of 1000. For illustration purposes, a packet is assumed to be sent at the sync interval 
with a propagation delay of 0; the offsets are arbitrarily assumed to be the same and initially 0, 
and the syncBoundsLimit is assumed to be a number smaller than 1000. 
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Figure 5-47.5 Example: Compensated Timestamp Between Nodes 


Interval | Master Source Node Destination Node 
Time 


Local | Offset Last Sys Sent Local | Offset Last Sys Recv 


Clock Offset | Time Time Clock Offset | Time Time 
stamp stamp 
T1 0 0 0 0 0 0 0 0 0 0 0 ” 
Adjusted 
| steo_| ims 
Step T2 100 100 0 0 100 100 100 0 0 100 100 
3 200 + 200 0+ 0 1200 1200 200 0 0 200 200 
1000 1000 
T4 1300 300 1000 (0) 1300 1300 300 0+ 0 1300 1300 
1000 
TS 1400 400 1000 1000 1400 1400 400 1000 1000 1400 1400 


At interval T3 a step change of 1000 occurs in the master clock and is seen by the source node 
clock. The timestamp received at the destination clock will be compensated for by 1000 and 
adjusted to a value consistent with the destination clock which has not yet seen the step change 
(recv timestamp adjusted from 1200 to 200). At interval T4 the destination node sees the step 
change but no adjustment is made to the timestamp because the source and destination 
compensations cancel out. After interval T4 and shown in interval T5, the last offset values are 
updated. 


A comparison of the compensated received timestamp and the current time system time will 
yield a meaningful and consistent result (200 and 200 vs. 1200 and 200). 


5-47.8 CIP Sync Group Startup Sequence 


CIP Sync defines a group startup sequence and a group synchronizing service. The group 
startup sequence allows a group of devices to guarantee that their clocks have all been 
synchronized to the PTP master reference clock before starting an application that depends on 
System Time. The application defines the specific requirements needed for the group to be 
considered synchronized. 


Each application (object) that wishes to synchronize to a group will implement the GroupSync 
service. The GroupSync service is a CIP Common service. See ODVA/CI CIP Common 
Specification, Volume 1, Appendix A. 


An application may send additional parameters as part of the group sync service. For example, 
it may exchange the SystemTimeOffset attribute to facilitate timestamp compensation, or a 
period and phase to initiate a synchronized periodic event, or one or more bounding parameters 
to specify a target synchronization requirement. 


The service returns true if the device is synchronized to the PTP Time master otherwise it 
returns false. 


An example startup sequence for a group of applications that need to synchronize is illustrated 
in the figure below. 
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Once the controller itself is synchronized to the master time clock, it initiates a series of 
GroupSync messages to each of the devices also part of the same group. Each device returns a 
response indicating whether it is also synchronized with the PTP master reference clock. If the 
controller and all devices are synchronized then the group is synchronized. Otherwise, the 
master application repeats the synchronizing sequence or takes some fault action. 


The Sync‘d status of each node is determined by the requirements of the application and may 
be contingent on additional synchronization parameters. 


Figure 5-47.4 Example Startup Sequence 


Controller 


Controller is Sync‘d Groupsync 


Device 1 is Sync‘d 


Device 2 is Sync‘d 


If controller or any device 
is no longer sync’d, repeat 
sequence 


Group is Synchronized 


CIP Sync Quality of Service (QoS) 


On EtherNet/IP, CIP Sync shall utilize the standard EtherNet/IP frame prioritization scheme to 
be published in Volume 2. This scheme has not yet been finalized but it is likely to utilize 
Tagged Frames, as defined by IEEE 802.1p, which has been formally incorporated into 
802.1Q. Some CIP Sync applications may require the use of Tagged Frames to achieve the 
required level of performance. Therefore, designers must consider the selection of hardware 


and firmware drivers to support “Tagged Frames" with user-selectable priority in their design. 
Table 5-47.1 QoS vs CIP Network Adaptation 


CIP Network Qos 
EtherNet/IP 802.1Q tagged frame 
DeviceNet N/A 
CompoNet N/A 
ControlNet scheduled priority 
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5-47.10 ‘Time Sync Status Visualization 


A device shall provide visual indication of clock synchronization status. Table 5-47.2 specifies 
the visual status of synchronization for various status indicators. 


A device is considered synchronized when its local clock is synchronized with the master 
reference clock. However, an application may impose more stringent synchronization 
requirements. 


Table 5-47.2 Time Sync Status Visualization 


Visual Status Indicator Operation 
Module Status LED Standby (flashing green) = not synchronized 
Operational (Solid green) = synchronized + other device requirements 
Seven Segment Display A device waiting for connection to the controller will display “0” 
A device configuring will display “1” 
A device waiting for synchronization will display “2” 
Multi-character A device waiting for synchronization will display “Synching” 
Alpha-Numeric Display A device that is a PTP Master will display “Time Master” 
A device that is a PTP Grandmaster will display “Time GM” 
Web or Property Page Identity of the current Grandmaster clock 
(suggested) Identity of the parent clock of a device 
Current system time 
Current grandmaster identifier (e.g. GPS, NTP, HAND, ATOM) 
Current grandmaster stratum 
Current offset to master 
Current observed variance of parent clock 
Current port status 


5-47.11 ‘Time Sync Object Overview 


The Time Sync Object provides a CIP interface to the IEEE 1588 (IEC 61588) Standard for a 

Precision Clock Synchronization Protocol for Networked Measurement and Control Systems, 

commonly referred to as the Precision Time Protocol (PTP). Any device supporting CIP Sync 
shall provide a single instance (Instance 1) of the Time Sync Object. Reference the IEEE 1588 
(IEC 61588) Standard for additional details. 


The object provides attributes and services to: 


1. Get clock status and properties such as synchronized state, current offset to master, and 
grandmaster UUID. 


2. Access PTP clock management functions on an individual clock, such as clock 
initialization, preferred mastership, and sync interval. 


Access the PTP network of devices via native PTP management messages. 
5-47.12 Class Attributes 

The Time Sync Object shall support the following class attributes. 

Table 5-47.3 Time Sync Object Class attributes 


Attrib Need in Access Name Data Type Description of Semantics of values 
ID Implementation | Rule Attribute 


These class attributes are optional and are described in Volume 1, Chapter 4 of the CIP Networks Library. 
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5-47.13. Instance Attributes 


The Time Sync Object supports the following instance attributes. 
Table 5-47.4 Time Sync Object Instance Attributes 


Attr | Needin | Access Name Data Type Description of Semantics of values 
ID Implem Rule Attribute 
1 | Required Set | EnablePTP BOOL Enable PTP See “Semantics” 
section 


Required Get | IsSynchronized BOOL Local clock is See “Semantics” 
synchronized with section 
reference clock 

3 | Required Set | CurrentTimeMicroseconds Current value of See “Semantics” 
local_time in section 

4 | Required Set | CurrentTimeNanoseconds Current value of See “Semantics” 
local_time in section 
nanoseconds 


microseconds 

5 | Required OffsetToMaster Offset between local See “Semantics” 
clock and master clock | section 

6 wel MaxOffsetToMaster Maximum offset See “Semantics” 


LIN 
between local clock section 


and master clock 


ieee Poe ce Path delay to master See “Semantics” 
section 


N 


oe) 


soon Clock communication | See “Semantics” 
technology section 
ee STRUCT | STRUCT of | Parent Clock Info 


opm STRUCT of | Grandmaster Clock 
Info 
— STRING[4] | Clock Identifer See “Semantics” 
section 
==——— Clock Stratum See “Semantics” 
section 
=— Clock Variance See “Semantics” 
section 
=——— ee inal See “Semantics” 
eee 
— RAY _ Clock UUID See “Semantics” 
Pe ee section 
Asser DINT Observed Drift See “Semantics” 
section 
ObservedVariance Observed Variance See “Semantics” 
section 
Variance Clock Variance See “Semantics” 
section 
CommunicationTechnology Clock communication | See “Semantics” 
technology section 
a 
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a Need in | Access Name Data Type Description of Semantics of values 
_ Rule Attribute 
UUID RAY of | Clock UUID See “Semantics” 
ae section 


10 Lo LocalClockInfo STRUCT of | Local Clock Info 


Identifier STRING[4] | Clock Identifer See “Semantics” 
section 

Stratum Clock Stratum See “Semantics” 
section 

Variance Clock Variance See “Semantics” 
section 

CommunicationTechnology Clock communication | See “Semantics” 
technology section 

PortId | Port Identifier See “Semantics” 
section 

UUID RAY aoa Clock UUID See “Semantics” 
eae section 

NumberOfPorts SINT Number of ports See “Semantics” 
section 


PortState STRUCT | STRUCT of | Port state | Port state of each port _| each | Port state of each port _| See “Semantics” 
INT [Number of ports aenon 
ARRAY err Port state of each port 
Fe 
PortEnable STRUCT Figen Port enable status See “Semantics” 
section 
ial of ports 
RAY Port enable status of 
each port 


jail 
ial 


of 
SINT 
14 | Required PortBurstEnable STRUCT of | Port burst enable status | See “Semantics” 
section 
ena Number of ports 
RAY of | Port burst enable status 
SINT of each port 
15 | Required Syncinterval SINT Sync Interval See “Semantics” 
section 
16 | Required PreferredMaster BOOL Preferred Master See “Semantics” 
section 
17 | Required Subdomain STRING[16] | PTP Clock subdomain | See “Semantics” 
section 
18 | Required ClockMode SINT Clock Mode See “Semantics” 
section 
19 | Optional StepsRemoved Steps Removed See “Semantics” 
section 
20 part acs SystemTimeOffset LINT System Time Offset See “Semantics” 
section 


5-47.13.1 Semantics 
5-47.13.1.1 Attribute 1: EnablePTP 
EnablePTP specifies whether the Precision Time Protocol is enabled for this device. The value 


is 1 if PTP is enabled and 0 if PTP is not enabled. 


— 5-550 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 6 


Time Sync Object, Class Code: 43hex 
5-47.13.1.2 Attribute 2: IsSynchronized 


IsSynchronized specifies whether the local clock is synchronized with the reference clock. The 
value is 1 if the local clock is synchronized and 0 if the local clock is not synchronized. A clock 
is synchronized if it has one port in the slave state and is receiving updates from the time 
master. However, an application may impose more stringent synchronization requirements. 


5-47.13.1.3 Attribute 3: CurrentTimeMicroseconds 


CurrentTimeMicroseconds specifies a 64-bit value of the current time in units of microseconds 
starting from January 1, 1970 at 12:00 a.m, Universal Coordinated Time (UTC). Leap seconds 
are distributed by the Precision Time Protocol as the current_utc_offset field. 


PTP time and leap seconds are converted to microseconds to give the current System Time as: 
CurrentTime = PTPTime + LeapSeconds 


Refer to the 1588 specification for a more detailed description of PTP time and the 
current_utc_offset field. 


5-47.13.1.4 Attribute 4: CurrentTimeNanoseconds 


CurrentTimeNanoseconds is the same as CurrentTimeMicroseconds except in units of 
nanoseconds. 


5-47.13.1.5 Attribute 5: OffsetToMaster 


OffsetToMaster specifies the amount of deviation between the local clock and the reference 
clock in nanoseconds. Refer to the 1588 specification for more detail. Also refer to the 
offset_from_master data member of the PTP current dataset. 


5-47.13.1.6 Attribute 6: MaxOffsetToMaster 


MaxOffsetToMaster specifies the maximum amount of deviation between the local clock and 
the reference clock in nanoseconds since last reinitialized. The MaxOffsetToMaster is settable, 
so that it may be reset. 


5-47.13.1.7. Attribute 7: DelayToMaster 


DelayToMaster specifies the path delay between the local clock and master clock in 
nanoseconds. Refer to the 1588 specification for more detail. Also refer to the one_way_delay 
data member of the PTP current dataset. 


5-47.13.1.8 Attribute 8: GrandmasterInfo 
5-47.13.1.9 Attribute 9: ParentInfo 
5-47.13.1.10 Attribute 10: ClockInfo 


GrandmasterInfo, ParentInfo, and ClockInfo specify clock property information for the 
Grandmaster, Parent and Local PTP clock respectively. The data is extracted from the PTP 
datasets maintained by the PTP subsystem. The CommunicationTechnology, UUID, and 
PortID constitute a clocks’ Universally Unique IDentifier (UUID). The clock identifier, 
stratum, variance, and drift provide additional information about the properties of the clock. 
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5-47.13.1.10.1 CommunicationTechnology 


CommunicationTechnology specifies the communication technology specifier (e.g. Ethernet). 
Refer to the 1588 specification for more detail. Also refer to the 
clock_communication_technology data member of the PTP default dataset and the 
parent_communication_technology and grandmaster_communication_technology of the parent 
dataset. 


Table 5-47.5 CommunicationTechnology Specifier Meanings 


CIP Network CommunicationTechnology 
EtherNet/IP 1 
DeviceNet 7 
ControlNet 9 
CompoNet TBD’ 


1 Value not yet assigned by IEEE 


5-47.13.1.10.2 UUID 


UUID specifies the Universally Unique [Dentifier (UUID) of the associated clock. For all CIP 
Networks except EtherNet/IP, the two-byte vendor id followed by the four byte serial number 
will be the defined UUID. Refer to the 1588 specification for a more detailed description. Also 
refer to the clock_uuid_field data member of the PTP default dataset and the parent_uuid_field 
and grandmaster_uuid_field of the parent dataset. 


Table 5-47.6 UUID Definition for CIP Network Adaptations 


CIP Network UUID 
EtherNet/IP MAC Address 
DeviceNet Vendor Id / Serial Number 
ControlNet Vendor Id / Serial Number 
CompoNet Vendor Id / Serial Number 


5-47.13.1.10.3  PortId 


PortId specifies the port identifier for the clock. For an ordinary clock the Portld value is 1. 
Refer to the 1588 specification for more detail. Also refer to the clock_port_id_field data 
member of the PTP default dataset and the parent_port_id_field and grandmaster_port_id_field 
of the parent dataset. 


5-47.13.1.10.4 Identifier 


Identifier specifies the expected absolute accuracy and epoch of a given clock (e.g. GPS, NTP, 
HAND). Refer to the 1588 specification for more detail. Also refer to the clock_identifier data 
member of the PTP default dataset and the grandmaster_identifier of the parent dataset. 


5-47.13.1.10.5 Stratum 


Stratum specifies an additional measure of the quality of a clock. Values are defined from 0 to 
255 with stratum 1 being the most closely linked to an authoritative source. (e.g. NTP with 
stratum 1 or 2). Refer to the 1588 specification for more detail. Also refer to the clock_stratum 
data member of the PTP default dataset and the grandmaster_stratum of the parent dataset. 
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5-47.13.1.10.6 Variance 


Variance specifies an estimated measure of the inherit stability properties of a clock. Refer to 
the 1588 specification for more detail. Also refer to the clock_variance data member of the PTP 
default dataset and the parent_variance and grandmaster_variance of the parent dataset. 


5-47.13.1.10.7 Observed Variance 


Observed Variance specifies an estimated measure of the parent clock’s variance as observed 
by the slave clock. Refer to the 1588 specification for more detail. Also refer to the 
observed_variance data member of the PTP parent dataset. 


5-47.13.1.10.8 Observed Drift 


Observed Drift specifies an estimated measure of the parent clock’s drift as observed by the 
slave clock. Refer to the 1588 specification for more detail. Also refer to the observed_drift 
data member of the PTP parent dataset. 


5-47.13.1.11 Attribute 11: NumberOfPorts 


NumberOfPorts specifies the number of PTP ports on the device. PTP Ordinary clocks have 
one port. Only a PTP Boundary clock will have more than one port. Refer to the 1588 
specification for more detail of a PTP port. Also refer to the number_of_ports data member of 
the PTP default dataset. 


5-47.13.1.12 Attribute 12: Port State 


PortState specifies the current status of each PTP port on the device as define by the PTP port 
state. (e.g. Initializing, Master, Slave, Faulted). The port assignments are device specific. Refer 
to the 1588 specification for more detail. Also refer to the port_state data member of the PTP 
port dataset. 


5-47.13.1.13 Attribute 13: Port Enable 


PortEnable specifies the port enable status of each port on the device. The value is set to 1 if 
the port is enabled and 0 if the port is disabled. Refer to the 1588 specification for more detail. 
Also refer to the port_state data member of the PTP port dataset. 


5-47.13.1.14 Attribute 14: Port Burst Enable 


PortBurstEnable specifies the port burst enable status of each port on the device. The value is 
set to 1 if the port burst is enabled and 0 if the port burst is disabled. Refer to the 1588 
specification for more detail. Also refer to the burst_enabled data member of the PTP port 
dataset. 


5-47.13.1.15 Attribute 15: SyncInterval 


SyncInterval specifies the PTP sync interval between successive “Sync” messages issued by a 
master clocks. The attribute does not take effect until after re-initialization. The default is 2 
seconds. The value is the logarithm base 2 of the sync interval. Refer to the 1588 specification 
for more detail. Also refer to the sync_interval data member of the PTP default dataset. 
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5-47.13.1.16 Attribute 16: IsPreferred 


IsPreferred specifies the “preferred” status of a master clock. The attribute indicates whether 
the clock is to be preferred in the selection of the grandmaster clock as part of the Best Master 
Clock Algorithm (BMCA). The attribute does not take effect until after re-initialization. The 
value is set to 1 if the clock is preferred and 0 if not. The default is 0. Refer to the 1588 
specification for more detail. Also refer to the preferred data member of the PTP default 
dataset. 


5-47.13.1.17 Attribute 17: Subdomain 


Subdomain specifies the PTP clock subdomain. The default subdomain is “_DFLT”. The 
attribute does not take effect until after re-initialization. Refer to the 1588 specification for 
more detail. Also refer to the subdomain_name data member of the PTP default dataset. 


5-47.13.1.18 Attribute 18: ClockMode 


ClockMode specifies the mode of the clock as “slave only” or “master capable” if this attribute 
is settable for a given device. It also reports its PTP clock type as an ordinary or boundary 
clock. A “master capable” device participates in the PTP Best Master Algorithm (BMCA) and 
may become a PTP master, while a “slave only” clock will not become a PTP master. The 
ClockMode is not settable for a boundary clock. 


Table 5-47.7 ClockMode Value Definition 


ClockMode Value 
Slave Only / Ordinary Clock 0 
Master Capable / Ordinary Clock 1 
Master Capable / Boundary Clock 2 


5-47.13.1.19 Attribute 19: StepsRemoved 


StepsRemoved specifies the number of communication paths traversed between the local clock 
and the grandmaster clock. Refer to the 1588 specification for more detail. Also refer to 
steps_removed data member of the PTP default dataset. 


5-47.13.1.20 Attribute 20: SystemTimeOffset 


SystemTimeOffset specifies the offset to the local clock value. This attribute only applies to a 
device that implements the CIP Sync clock offset model. The responding device will return the 
current System Time Offset, otherwise zero. 


5-47.14 Common Services 


The Time Sync Object provides the following common services. 


Table 5-47.8 Common services 


Need in Implementation 


5-47.15 | Object-Specific Services 


Service 
Code 


Service Name Description of Service 


Per Appendix A 


Per Appendix A 


Per Appendix A 
Per Appendix A 
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The Time Sync Object shall support the following object-specific services: 
Table 5-47.9 Object specific services 


Need in Implementation 


4Anex n/a ManagementMessage 


Note1: Required for Master Capable devices. Optional for Slave Only devices. 


Service 
Code 


Service Name Description of Service 


Initialize Time Sync Object 


Initiate a PTP management message 


5-47.15.1 Initialize Service 


The Initialize service causes the PTP Clock to initialize to its power up state. The service is 
typically invoked after a configuration change to the Time Sync object. An initialize service 
also causes the PTP clock to re-synchronize to the current PTP master reference clock. Refer to 
the 1588 specification for more detail. 


5-47.15.2 ManagementMessage Service 


The ManagementMessage service causes the recipient to initiate a native PTP management 
message to one or more PTP clocks. This service provides CIP access to the complete set of 
PTP management messages. It also provides a broadcast mechanism not present in CIP and 
needed for certain operations such as InitializeClock to reinitialize all the PTP clocks in the 
system. It also provides a mechanism for accessing non-CIP network clocks. The list of 
supported PTP commands is enumerated in Table 5-47.11. Refer to the 1588 standard for a 
detailed description of each command and the appropriate request and response parameters. 


The service request is received by a particular device. The device then issues a corresponding 
PTP management message using the native communication mechanism (e.g. PTP/UDP over 
Ethernet). The device waits for the response if a response is expected for the particular 
command and then responds with an appropriate CIP response, otherwise a success response is 
sent immediately. The message will propagate through the entire PTP system until it reaches its 
targeted destination. 


Table 5-47.10 Request/Response Message Format 


Name Data Type Description of Parameter Semantics of values 


Management Message Payload Request and/or Response See specific Management 
parameters Message sections in the 
1588 standard. 


Table 5-47.11 1588 Management Messages 


Management Message Command 


ObtainIdentity GetGlobalTimeDataSet 
InitializeClock UpdateGlobalTimeProperties 
SetSubDomain GoToFaultyState 
ClearDesignatedPreferredMaster GetForeignDataSet 
SetDesignatedPreferredMaster SetSyncinterval 
GetDefaultDataSet DisablePort 
UpdateDefaultDataSet EnablePort 
GetCurrentDataSet DisableBurst 
GetParentDataSet EnableBurst 
GetPortDataSet SetTime 
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5-48 Connection Configuration Object 
Class Code: F3hex 


This object defines an interface used to create, configure and control CIP connections in a 
device. This specification does not define or constrain the operation of the device’s connection 
management state machine. 


NOTE: The CCO object is a device addressable object (not a port addressable object). Refer to 
Chapter 10 for a discussion about scope of objects. 


5-48.1 Class Attributes 


Table 5-48.1 Connection Configuration Object Class Attributes 


ae Needin | Access Name Data __| Description of Attribute | Semantics of 
Implem Rule Type Value 
Required NV | Revision UINT Third revision, value = 3 | See Chapter 5- 
48.1.1.1 

Required Get NV | Max Instance UDINT Maximum instance 

number 
Required NV _ | Num Instances UDINT Number of connections 

currently instantiated 


This class attribute is optional and is described in Chapter 4 


5 | Conditional ° | Get NV | Optional service | Struct of: | List of optional services | A list of service 
utilized in an object class | codes specifying 
implementation the optional 

services 

implemented in 
the device for this 


class. 


Number services | UINT Number of services in the | The number of 
optional service list service codes in 
the list 


Optional services | Array of | List of optional service | The optional 
UINT codes service codes. 
6 


and | These class attributes are optional and are described in Chapter 4 
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Attr Needin_ | Access | NV Name Data Description of Attribute | Semantics of 
ID Implem Rule Type Value 


10 
thru | Reserved 
32 


33 | Optional Set '* |NV | Scanner Mode BOOL The originator to target | 0 = idle mode 
packets for connections | 1 = run mode 
originated by this device 
shall reflect the state of 
this attribute. 


34 | Optional Get Vv Scanner sate Bit 0, set to Scanner Bits 0-10 
Capabilities Mode (attribute 33) = 0, No 

supported * =1, Yes 
Bit 1, set to Scanner 
Mode (attribute 33) 
currently supported 
Bit 2, Instances may 
currently be created in 
Run mode 
Bit 3, Instances may 
currently be changed in 
Run mode 
Bit 4, Instances may 
currently be deleted in 
Run mode 
Bit 5, Instance may 
currently be created in 
Idle mode 
Bit 6, Instances may 
currently be changed in 
Idle mode 
Bit 7, Instances may 
currently be deleted in 
Idle mode 
Bit 8, 
Open_Connection/Close_ 
Connection services 
supported 
Bit 9, Stop_Connection 
service supported 
Bit 10, Get_Member 
service to read image 
tables supported 
Bits 11-15 — reserved and 
shall be zero 
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Attr Needin | Access | NV Name Data _ | Description of Attribute} Semantics of 
ID Implem Rule Type Value 


1-A set to attribute 33 shall return a device state conflict (0x10) error if changing the Scanner Mode is not 
permitted when the set attribute command is received. 


2 — The value of attribute 33 may be different than the value last set to attribute 33 if another mechanism (like a 
key switch) changed the scanner’s mode. 


3 — Bit 0 indicates if the Scanner Mode attribute has the ability to ever be set using a set attribute service. 


4 — If the device in which this object is implemented has some sort of mechanism for changing connections, the 
state of these bits shall be changed to reflect the present state of the device. 


5 — Required if object supports any optional services. Optional if object does not support any optional services. 
The additions made to this Object with revision 2 are: 
Definition of Connection Status attribute for target-side, peer-to-peer connections 


In the Connection Flags Attribute defined bits 4-6 for “T=>O Real time transfer format”. 
Changed the name of bits 1-3 from “Idle Style” to “O=>T Real time transfer format” and 
defined the value=3 for “Heartbeat” 


Changed the Object Specific service Get_Status from optional to required, and changed the 
Set_Attribute_Single service from required to optional. 


Added Instance attribute 11, Proxy Device ID. Updated the Get_Attributes_All response and 
Set_Attributes_all request to include attribute 11. 


5-48.1.1 Semantics 
5-48.1.1.1 Revision — UINT data type 


Defines the revision of the Connection Configuration Object Class Definition upon which the 
implementation is based. As time progressed it is possible for technical updates of the 
Connection Configuration Object Class Definition to occur for which an indication is 
desireable. This attribute enables these updates to be tracked inside devices. 


The current value assigned to this attribute is three (3). If updates which require an increase in 
this value are made, then the value will be increased. Support of this attribute is required. 


Table 5-48.2 Revision History 


Revision Reason for change and description of change from previous revision 
0x0001 Initial Definition 
0x0002 Added class attributes 33 and 34 
0x0003 Modification to make class attribute 5 conditional 
0x0004 — OxFFFF | Reserved by CIP 
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Format Number 
The format value that shall be specified in the format field of each instance of attribute 9. 
Values: 
0 — Single O->T/T->O tables, 16-bit words, 0-based offsets 
1-— Multiple O->T/T->O tables, 16-bit words, 0-based offsets 
2 - 99 — Reserved 


100 - 199 — Vendor Specfic 
All other values reserved 


Edit Signature 


Created and used by configuration software to detect modification to the instance attribute 
values. For ControlNet this value is initially 0 and is incremented each time a change complete 
operation is performed. For all other CIP networks this value is initially 0 and is set to a 32 bit 
CRC each time a change complete operation is performed (the polynomial is 
XANB24+XN264+KN234+KN22+KN16FKN124XN114+XKN104+XNB+XN7+KN5+KN4+KN24KN1+/0), the CRC 
seed value shall be 0. The CRC is calculated on the set all attribute data stream for each 
connection instance (lowest to highest) plus class attribute 1, class attribute 2, class attribute 3 
and class attribute 8. 


Instance Attributes 


Table 5-48.3 Connection Configuration Object Instance Attributes 
Attr Need in Access | NV Name Data Description of Semantics of 
ID Implem Rule Type Attribute Values 
1 | Required Get V_ | Connection Status Struct of | This attribute is the See Semantics 
connection status. section 


2 | Required Set NV | Connection Flags WORD Connection flags See Semantics 
q § § 


Required Set NV | Target Device ID Struct of See Semantics 
section 
t 


Minor revision 


4 | Conditional S NV | CS Data Index UDINT See Semantics 
Number section 


e 
e 


— 5-559 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 6 


Connection Configuration Object, Class Code: F3hex 


Attr Need in Access | NV Name Data Description of Semantics of 
ID Implem Rule Type Attribute Values 


5 | Required Set NV | Net Connection Struct of 

Parameters 

conn_timeout USINT Connection Timeout | See Semantics 
Multiplier section 

xport_class_and_trig BYTE Transport Class and | See Semantics 
Trigger section 

rpi_OT UDINT | Originator to Target | See Semantics 
Requested Packet section 
Interval 

net_OT UINT Originator to Target | See Semantics 
network connection section 
parameters 

rpi_TO UDINT | Target to Originator | See Semantics 
Requested Packet section 
Interval 

net_TO UINT Target to Originator | See Semantics 
network connection section 
parameters 


open_path_size USINT | Open connection path | See Semantics 
size section 


open connection path | Padded | Connection path See Semantics 
EPATH section 


7 |Required {Set —_| NV | Config #1 Data pee See Semantics 
section 
config_data_size UINT Length of 
config_data in bytes. 
config_data Array of | Config #1 data 
octet 


8 | Required Set NV | Connection Name Struct of See Semantics 
section 
name_size USINT | Number of characters 
in the connection 
name. 
et 


connection_name STRING2 | User-assigned 
connection name 
encoded in 
UNICODE. 


NV | I/O Mapping Struct of See Semantics 
section 


format_number UINT This number The format value 
determines the format | shall match the 
of this attribute. value of class 
attribute 8. 


mapping _data_size UINT Size in bytes of the 


9 | Required S 


mapping. data field 
that follows. 
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Attr Need in Access | NV 
ID Implem Rule 
10 | Required Set NV 
11 | Required Set NV 
12 | Conditional’ | Set NV 
13. | Conditional * 
14 | Conditional * 
15 | Conditional * 
16 | Conditional * 
17. | Conditional * 
18 | Optional Set 


Name 


mapping_data 


Config #2 Data 


config_data_size 


config_data 


Proxy Device ID 


vendor_id 
product_type 
product_code 
major_rev 
minor_rev 


Connection Disable 


Safety Parameters 


Safety Connection 
Parameter CRC 


Safety Configuration 
Instance 


Safety ID Allocation 


Safety Target 
Connection Serial 
Number 


Net Connection 
Parameters Attribute 
Selection 
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Data 
Type 


Array of 
BYTE 


Struct of 


UINT 


Array of 
octet 


Struct of 


UINT 
UINT 
UINT 
USINT 
USINT 
BOOL 


USINT 


Description of 
Attribute 


I/O mapping 
information 
associated with this 
instance. 


Length of 


config_data in bytes. 


Config #2 data 


Vendor ID 
Device Type 
Product Code 
Major revision 
Minor revision 


Indicates if this 
instance of the 
connection 
configuration object 
is disabled 


Semantics of 
Values 


See Semantics 
section 


See Semantics 
section 


0 — This instance 
of the connection 
configuration 
object is enabled. 
1— This instance 
of the connection 
configuration 
object is disabled. 
When an Open 
service is received 
this value shall be 
set to 0. When a 
Close or Stop 
service is received 
this value shall be 
set to 1. 


See CIP Safety Specification 
(Volume 5, Chapter 5) 


Selects between 
attribute 5 and 
attribute 19 


ODVA & ControlNet International, Ltd. 


See Semantics 
section 
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ID 


19 
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Need in Access | NV 
Implem Rule 
Conditional? | Set 


Conditional * 


21 


Conditional * 


22 


Conditional ” 


Name 


Large Net 
Connection 
Parameters 


conn_timeout 
xport_class_and_trig 


ger 


rpi_OT 


net_OT 


rpi_TO 


net_TO 


Format Type 
Format Status 


Max Fault Number 


Data 
Type 
Struct of 


USINT 


BYTE 


UDINT 


UDINT 


UDINT 


UDINT 


Description of 
Attribute 


Connection Timeout 
Multiplier 


Transport Class and 
Trigger 


Originator to Target 
Requested Packet 
Interval 


Originator to Target 
large network 
connection 
parameters 


Target to Originator 
Requested Packet 
Interval 


Target to Originator 
large network 
connection 
parameters 


Semantics of 
Values 


See Semantics 
section 


See Semantics 
section 


See Semantics 
section 


See Semantics 
section 


See Semantics 
section 


See Semantics 
section 


See CIP Safety Specification 
(Volume 5, Chapter 5) 


1 Attribute 12 shall be supported if conditional services Open_Connection (4C) and Close_Connection (4D) are 
supported. Attribute 12 shall not be supported if conditional services Open_Connection (4C) and 
Close_Connection (4D) are not supported. 


2 These attributes are not allowed if the device is not a safety device. If the device is a safety device, see Volume 
5, CIP Safety. 


3 Conditional attribute 19 is required if attribute 18 is supported, otherwise conditional attribute 19 is not allowed. 


5-48.2.1 


I/O Mapping Formats 


The following tables describe the structure of the mapping_data field of instance attribute 9 for 
each of the format numbers. 


Table 5-48.4 Mapping Formats 


Format Mapping_data_size Name Data Description 
Number (in bytes) Type 
Single I/O tables Struct of: | 16 bit words, 0 based 16 bit word 
offsets 
° - O->T offset UINT Offset into O->T image table. 
T->O offset UINT Offset into T->O image table. 
Multiple I/O tables Struct of: Table selection, 16 bit words, 0 
based 16 bit word offsets 
O->T table UINT O->T image table selection 
: O->T offset UINT Offset into O->T image table. 
T->O table UINT T->O image table selection 
T->O offset UINT Offset into T->O image table. 
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5-48.2.2. Semantics 
5-48.2.2.1 Connection Status 


Table 5-48.5 Originator Connection Status Values 


General Extended Description 
Status Status 


0x00 n/a Connection is open 
0x01 0x0000 or | See the table of Connection Manager Service Request Error Codes in 
greater Volume 1, Chapter 3, in the Error Code Listing subsection 
0x02 — 0x26 0x0000 or | See General Status codes, Volume 1, Appendix B 
greater 
0x0001 Connection is closed or stopped (via the Close or Stop services) 
0xDO 0x0002 Connection open is pending 
0x0003 Connection close is pending 


General Description 
Status 
0x00 Connection is not open 
0x00 The number of connections to this target 
0xDO Connection is closed or stopped (via the Close or Stop services) 


5-48.2.2.2 Connection Flags 
Table 5-48.7 Connection Flags Attribute Definition 


Bit Meaning 
0 Connection 
0 = Originator 
1 = Target 
1-3 O->T Real time transfer format 


000 — Use 32-bit Run/Program header to indicate idle mode, Volume 1, Section 3-6.1.4. 
001 — Use zero data length packet to indicate idle mode. 
010 — None. Connection is pure data and is modeless. 
011 — Heartbeat. 
100 — Reserved. 
101 — Safety (See Volume 5) 
100 thru 111 — reserved for future use. 
4-6 T->O Real time transfer format 
000 — Use 32-bit Run/Program header to indicate idle mode, Volume 1, Section 3-6.1.4 
001 — Use zero data length packet to indicate idle mode. 
010 — None. Connection is pure data and is modeless. 
011 — Heartbeat. 
100 — Reserved. 
101 — Safety (See Volume 5) 
100 thru 111 — reserved for future use. 
7-15 | Reserved 
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5-48.2.2.3 Target Device ID 


This attribute is the identity of the target device for this connection instance. This identity 
information is not used for verifying (keying) the online target device, it is used by a 
configuration tool to locate the correct electronic data sheet for the connection configuration 
described in this CCO instance. For Target instances this attribute shall be the identity of the 
device containing this CCO object. 


5-48.2.2.4 CS Data Index Number 


The CS Data Index Number attribute is required for a device on ControlNet; otherwise this 
attribute shall not be implemented. 


The CS Data Index Number is a value set by the configuration software. This is the 
connection_index value returned from the Schedule Object read service (See Volume 4, 
ControlNet Adaptation of CIP, Chapter 5 for the definition of the Scheduling Object services). 
This attribute is ignored for target instances. 


5-48.2.2.5 Net Connection Parameters 
5-48.2.2.5.1 conn_timeout 


The conn_timeout is the value used for the connection timeout multiplier field defined in 
Volume 1, Chapter 3 for a description of the Forward_Open service request. conn_timeout is 
ignored for target instances. 


5-48.2.2.5.2 xport_class_and_trig 


The xport_class_and_trig is the value used for the Transport Type/Trigger field defined in 
Volume 1, Chapter 3 for a description of the Forward_Open service request. xport_class 
and_trig is ignored for target instances. 


5-48.2.2.5.3 rpi_OT 


The rpi_OT is the value used for the O_to_T RPI field defined in Volume 1, Chapter 3 for a 
description of the Forward_Open service request. rpi_OT is ignored for target instances. 


5-48.2.2.5.4 net_OT 


The net_OT is the value used for the O_to_T Network Connection Parameters field in Volume 
1, Chapter 3 for a description of the Forward_Open service request. Only the size field is used 
for target instances. 


5-48.2.2.5.5 rpi_TO 


The rpi_TO is the value used for the T_to_O RPI field defined in Volume 1, Chapter 3 for a 
description of the Forward_Open service request). rpi_TO is ignored for target instances. 


5-48.2.2.5.6 net_TO 


The net_TO is the value used for the T_to_O Network Connection Parameters field in Volume 
1, Chapter 3 for a description of the Forward_Open service request. Only the size field is used 
for target instances. 
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5-48.2.2.6 Connection Path 
5-48.2.2.6.1 open_path_size 


The open_path_size is the value used for the Connection_Path_size field in Volume 1, Chapter 
3 for a description of the Forward_Open service request. For target instances the 
open_path_size is used for matching the open_path_size received in a forward open. 


5-48.2.2.6.2 open connection path 


The open_connection_path is the value used for the Connection_Path field in Volume 1, 
Chapter 3 for a description of the Forward_Open service request. For target instances the 
open_connection_path is used for matching the open_connection_path received in a forward 
open. 


5-48.2.2.7 Config #1 Data 


This does not apply to target instances. The data specified in attributes 7 and 10 are 
concatenated (in that order) into a single data segment, then appended to the connection path in 
attribute 6 to form the complete path sent in the Forward_Open service of the Connection 
Manager object. 


All the configuration data may be placed in attribute 7 or all the configuration data may be 
placed in attribute 10 or the configuration data may be split between attributes 7 and 10. When 
a connection is a proxied connection the convention that shall be followed is that any 
configuration data intended for the proxying device is placed in attribute 7 and any 
configuration data intended for the proxied device is placed in attribute 10. For connections to 
devices that are configured using the target device EDS this information comes from the 
Connection Manager section of the EDS, fields 9 and 10 of the Connection entry (see the 
Connection Manager Section of Volume 1, Chapter 7 for more information). Config #1 data is 
ignored for target instances. 


5-48.2.2.8 Connection Name 


This Connection Name field allows a user to name each connection instance. The connection 
name has no meaning to the Connection Configuration Object. 


5-48.2.2.9 I/O Mapping Attribute 


The I/O Mapping attribute contains I/O mapping data. The I/O mapping data specifies image 
table locations where target to originator data is placed and where originator to target data is 
obtained. 


5-48.2.2.10 Config #2 Data 


This note does not apply to target instances. The data specified in attributes 7 and 10 are 
concatenated (in that order) into a single data segment, then appended to the connection path in 
attribute 6 to form the complete path sent in the Forward Open service of the Connection 
Manager object. All the configuration data may be placed in attribute 7 or all the configuration 
data may be placed in attribute 10 or the configuration data may be split between attributes 7 
and 10. When a connection is a proxied connection the convention that shall be followed is that 
any configuration data intended for the proxying device is placed in attribute 7 and any 
configuration data intended for the proxied device is placed in attribute 10. For connections to 
devices that are configured using the target device EDS this information comes from the 
Connection Manager section of the EDS, fields 11 and 12 of the Connection entry (see the 
Connection Manager Section of Volume 1, Chapter 7 for more information). Config #2 data is 
ignored for target instances. 
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5-48.2.2.11 Proxy Device ID 


This attribute is the identity of the device proxying for the target device for this connection 
instance. This identity information is not used for verifying (keying) the online target device, it 
is used by a configuration tool to locate the correct electronic data sheet for the connection 
configuration described in this CCO instance. For Target instances and Connections that are 
not proxied this attribute shall be ignored. 


5-48.2.2.12 Net Connection Parameters Attribute Selection 


The Net Connection Parameters Attribute Selection attribute selects between the use of 
instance attribute 5 (Net Connection Parameters) and attribute 19 (Large Net Connection 
Parameters). The valid values are: 


O = indicates instance attribute 5 shall be used (default) 
1 = indicates instance attribute 19 shall be used 
2-255 = reserved 
If this optional attribute is not supported attribute 5 shall be used. 


5-48.2.2.13 Large Net Connection Parameters 


5-48.2.2.13.1 conn_timeout 


The conn_timeout is the value used for the connection timeout multiplier field defined in 
Volume 1, Chapter 3 for a description of the Large_Forward_Open service request. 
conn_timeout is ignored for target instances. 


5-48.2.2.13.2 xport_class_and_trig 


The xport_class_and_trig is the value used for the Transport Type/Trigger field defined in 
Volume 1, Chapter 3 for a description of the Large_Forward_Open service request. 
xport_class and_trig is ignored for target instances. 


5-48.2.2.13.3. rpi_OT 


The rpi_OT is the value used for the O_to_T RPI field defined in Volume 1, Chapter 3 for a 
description of the Large_Forward_Open service request. rpi_OT is ignored for target instances. 


5-48.2.2.13.4 net_OT 


The net_OT is the value used for the O_to_T Network Connection Parameters field in Volume 
1, Chapter 3 for a description of the Large_Forward_Open service request. Only the size field 
is used for target instances. 


5-48.2.2.13.5 rpi_TO 


The rpi_TO is the value used for the T_to_O RPI field defined in Volume 1, Chapter 3 for a 
description of the Large_Forward_Open service request). rpi_TO is ignored for target 
instances. 


5-48.2.2.13.6 net_TO 


The net_TO is the value used for the T_to_O Network Connection Parameters field in Volume 
1, Chapter 3 for a description of the Large_Forward_Open service request. Only the size field 
is used for target instances. 
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5-48.3 Connection Configuration Object Change Control 


Changes to Connection Configuration object attributes can only be made after a Change Start 
service has been successfully issued. Changes to Connection Configuration object attributes 
are applied after a Change Complete service has been successfully issued. 


The following services are valid during a change operation. A change operation is started by 
issuing a Change Start service and completed by issuing a Change Complete service: 


Table 5-48.8 Services Valid During a Change Operation 


Service Code Service Name 


O2hex Set_Attribute_All 

O8hex Create 

O9hex Delete 

10hex Set_Attribute_Single 

15hex Restore 

4Bhex Kick Timer 

51hex Change Complete 

52hex Audit Changes 
5-48.4 Common Services 


The Connection Configuration Object provides the following Common Services: 


Table 5-48.9 Connection Configuration Object Common Services 


Need in 
Service Implementation Service Name Description of Service 


O1hex Gets all attributes of the specified instance. 
O2hex |N/A Sets all attributes of the specified instance. 
O8hex Creates a new connection instance. 

O9hex Deletes an existing connection instance. 
OEhex Returns the contents of the specified attribute. 
10hex Modifies an attribute value. 

15hex Restore current connection attributes. 


See Appendix A for description of these services 


5-48.4.1 Get_Attributes_All (Service Code 0x01) 


At the Class level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows: 


Table 5-48.10 Get_Attributes_All Response Data — Class Level 


Name Data Type | Description 

Max Instance UDINT Maximum instance number 

Num Instances UDINT Number of connections currently instantiated 

Format Number | UDINT The format value that shall be specified in the format field of each instance of 


attribute 9 


Edit signature UDINT Value created and used by configuration software to detect modification to the 


Revision UINT Object revision | 
instance attribute values | 
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At the Instance level, the order of the attributes returned in the “Object/service specific reply 
data” portion of the Get_Attributes_All response is as follows: 


Table 5-48.11 Get_Attributes_All Response Data — Instance Level 


Name Description 
Connection Connection status information. When the connection is not open, this 
Status attribute contains an error code indicating the reason. 
General status. 
Extended status. 
Connection Flags Connection Flags. 
Target Device Id Target Device identification. 
Vendor Id 
Product Type 
Product Code 
Major Revision 
Minor Revision 
CS Data Index ControlNet Scheduling object read data connection_index number. The 
Number default value used when this attribute is not supported shall be 
OxFFFFFFFF. 
Net Connection Network connection parameters for both originator-to-target and target- 
Parameters to-originator directions. 
USINT The connection time-out multiplier. 
BYTE Transport class and trigger. 
UDINT Originator-to-target RPI. 
Originator-to-target network connection parameters. 
Target-to-originator RPI. 
Target-to-originator network connection parameters. 
Connection Path The connection path. 
Size of connection path, in 16-bit words, used in the Connection 
Manager Forward Open request service 
Reserved. Shall be zero 
The connection path. The open connection path size is the length of this 
UINT array. 
Config #1 Data Config #1 data. This data is sent to devices via the Connection Manager 
Forward Open request service 
configuration data length in bytes. 
configuration data. Padded to an even number of bytes. 
Config #2 Data Config #2 data. This data is sent to devices via the Forward_Open 
service 
configuration data length in bytes. 
Module configuration data. Padded to even number of bytes. 
USINT 
Connection Name The connection name. 
Number of characters in connection name. 
Connection name encoded in UNICODE. 
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Name Description 

1/O Mapping The I/O Mapping. 

Format number. 

Attribute size in bytes. 

Attribute data. Padded to an even number of bytes. 
Proxy Device Id Proxy Device identification. 

Vendor Id 

Product Type 

Product Code 

Major Revision 

Minor Revision 


Safety Parameters 


See Safety 
Volume See CIP Safety Specification (Volume 5, Chapter 5). These 55 


(Volume 5, octets are included in the Get_Attribute_All response only if 
Chapter 5) either the O=>T or T=>O real time transfer format in the 
Connection Flags Attribute (attribute 2) indicates the format is 
55 octets total | Safety. 


Connection BOOL Bit 0, value of connection disable attribute (attribute 12) if supported. 0, 
Disable if connection disable attribute is not supported. 

Net Connection USINT Selection of Net Connection Parameters attribute or Large Net 
Parameters Connection Parameters attribute if supported. 0 if Net Connection 
Attribute Parameters Attribute Selection is not supported. 

Selection 


Large Net Struct of Network connection parameters for both O=>T and T=>O. 
Connection 
Parameters 


The connection time-out multiplier. 
Transport class and trigger. 
O->T network connection parameters 


UDINT T->O network connection parameters 
Additional Safety See Safety See CIP Safety Specification (Volume 5, Chapter 5). This group of 
Parameters Volume parameters may be included in the Get_Attribute_All response only if 


(Volume 5, either the O=>T or T=>O real time transfer format in the Connection 
Chapter 5) Flags Attribute (attribute 2) indicates the format is Safety. 


Variable length. 
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Set_Attributes_All (Service Code 0x02) 


This service modifies the contents of the attributes shown in Table 5-48.13 and supports the 
following error codes in addition to other error codes listed in Appendix B: 


Table 5-48.12 Set_Attributes_All Service Request Errors 


General Status Extended Error Name Description 
Status 


0x0C None Object State The Connection Configuration Object cannot 
Conflict accept the Set_Attribute_Single service when an 
edit session is not active 


The structure of the Set_Attributes_A1l Request is shown in the table below. 
Table 5-48.13 Set_Attributes_All Service Request 


Name Data Type Description 
Connection Flags WORD Connection flags. 
Target Device Id Target Device identification. 
Vendor Id 
Product Type 
Product Code 
Major Revision 
Minor Revision 
CS Data Index ControlNet Scheduling object read data connection_index number. The 
Number default value used when this attribute is not supported shall be 
OxFFFFFFFF. 
Net Connection Network connection parameters for both OT and T=>0 directions. 
Parmeter The connection time-out multiplier. 
Transport class and trigger. 
O=T RPI. 
OT network connection parameters. 
T=>0 RPI. 
T=>0 network connection parameters. 
Connection Path The connection path. 
USINT Size of connection path, in 16-bit words, used in the Connection Manager 
Forward Open request service 
USINT reserved. shall be zero. 
Array of The connection path. The open connection path size is the length of this 
UINT array. 
Config #1 Data Struct of Config #1 data. This data is sent to devices via the Connection Manager 
Forward Open request service 
UINT Module configuration data length in bytes. 
Array of Module configuration data. Padded to even number of bytes. 
USINT 
Config #2 Data Struct of Config #2 data. This data is sent to devices via the Connection Manager 


Forward Open request service 
UINT Module configuration data length in bytes. 


Array of Module configuration data. Padded to even number of bytes. 
USINT 
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Name Data Type Description 


Connection Name The connection name. 
Number of characters in connection name. 
Connection name encoded in UNICODE. 
1/O Mapping The I/O Mapping. 
Format number. 
Attribute size in bytes. 


Array of Attribute data. Padded to an even number of bytes. 
USINT 


Proxy Device Id Proxy Device identification. 
Vendor Id 
Product Type 
Product Code 
Major Revision 
Minor Revision 


Safety Parameters See Safety | See CIP Safety Specification (Volume 5, Chapter 5). These 49 
Volume octets are included in the Set_Attribute_All service data only if 
(Volume 5, | either the O=>T or T=>O real time transfer format in the 


Chapter 5) | Connection Flags Attribute (attribute 2) indicates the format is 
49 octets Safety. 
total 

Connection BOOL Bit 0, value of connection disable attribute (attribute 12). 
Disable 
Net Connection USINT Selection of Net Connection Parameters attribute or Large Net Connection 
Parameters Parameters attribute if supported. 
Attribute Selection 


Large Net Struct of Network connection parameters for both O=>T and T=>O. 
Connection 
Parameters 


USINT The connection time-out multiplier. 


Transport class and trigger. 


BYTE 
UDINT O->T RPI 


UDINT O->T network connection parameters 
UDINT T->O RPI 
U 


DINT T->O network connection parameters 


Additional Safety | See Safety See CIP Safety Specification (Volume 5, Chapter 5). This group of 


Parameters Volume parameters may be included in the Set_Attribute_All response only if 
(Volume 5, either the O=>T or T=>O real time transfer format in the Connection Flags 
Chapter 5) Attribute (attribute 2) indicates the format is Safety. 
Variable 
length. 


Create (Service Code 0x08) 


This service creates a new instance of a Connection Configuration object. Initial attribute 
values may also be specified with this service. The created instance number is assigned by the 
class and returned to the requestor. The following request parameters are defined for this 
service: 
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Table 5-48.14 Create Service Request 


Parameter Data Type Description 
Connection Flags | WORD Connection flags 
NumConnParams | UINT Number of attribute/value pairs that follow. 


ConnParams Array of Struct of List of attribute number/value pairs 


Ss 
Z 
4 


Attribute number 


Object/class attribute-specific Attribute value 
Struct 


This service supports the following error codes in addition to other error codes listed in 
Appendix B: 


Table 5-48.15 Create Service Request Errors 


| el os Descriton 

| 0x02 0x0001 The maximum number of instances already exist 
| 0x0002 Not enough memory on device 

| 0x03 one The attribute count is invalid 

| 0x08 one Unimplemented service 

| 

| 


0x0C Object State conflict The Connection Configuraton Object cannot 


execute the Set_Attribute_Single service when an 
edit session is not active 


0x0E one Attribute not settable Attempt to set a read-only attribute 
0x13 one Not enough data The request was too short or truncated 


0x1C None Missing attribute list entry | The required attribute was missing 
data 


5-48.4.4 Delete (Service Code 0x09) 


This service deletes existing connection instances. If addressed to the class-level, all 
connection instances are deleted. If addressed to the instance-level, only the addressed instance 
is deleted. This service supports the following error codes in addition to other codes listed in 
Appendix B: 


=) 
oO 


Table 5-48.16 Delete Service Request Errors 


Extended rae 
General Status Error Name Description 
Status 
0x0C None Object State conflict The Connection Configuration Object cannot 
execute the Delete service when an edit session 
is not active 


5-48.4.5 Restore (Service Code 0x15) 


This service shall discard modifications to instances that have not yet been committed by the 
Change_Complete service. If the Restore service is addressed to the class (instance 0), then 
pending modifications for all instances shall be discarded and the edit session shall be ended. 
If addressed to a specific instance, only modifications for that instance shall be discarded and 
the edit session shall not be ended. 


— 5-572 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 5: Object Library, Part 6 


Connection Configuration Object, Class Code: F3hex 
This service supports the following error codes in addition to other error codes listed in 
Appendix B: 
Table 5-48.17 Restore Service Request Errors 


Extended Error Name Mee 
General Status Description 
Status 


0x0C Object State conflict The Connection Configuration Object cannot 
execute the Restore service when an edit session 
is not active 


5-48.4.6 Object-specific Services 
The Connection Configuration Object provides the following Object Specific Services: 


Table 5-48.18 Connection Configuration Object Object-specific Services 


Service Service Name Description of Service 
4Bhex Kicks Edit Watchdog Timer 
4Chex Opens connections 

4Dhex Closes connections 

4Ehex Stops connections 

4Fhex Manages session editing 

50hex Get status for multiple connections 
5ihex Completes session editing 

52hex Audits pending changes 


*The Open_Connection and Close_Connection services shall either both be supported or neither the 
Open_Connection or Close_Connection services shall be supported. The Stop_Connection 
service may only be supported if the Open_Connection service is supported 


5-48.4.7. Kick_Timer (Service Code 0x4B) 


This service shall reinitialize the edit watchdog timer. Upon successful execution of the 
Change_Start service, the edit watchdog timer shall be started with a period of 60 seconds. 
This timer is used to recover from the loss of a configuration client between the Change_Start 
and Change_Complete/Restore operations. Receipt of any service request shall reset the edit 
watchdog timer. Clients may request this service to reset the timer without otherwise affecting 
the state of the Connection Configuration object. If the edit watchdog timer expires, all 
pending modifications shall be discarded and the edit session shall be ended. 


5-48.4.8 | Open_Connection (Service Code 0x4C) 


The Open_Connection service shall cause the connection associated with an instance of the 
Connection Configuration object to open. If the Open_Connection service is addressed to the 
class (instance 0), then all connection instances shall be opened. If addressed to a specific 
instance, then only that connection instance shall be opened. 
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Close_Connection (Service Code 0x4D) 


The Close_Connection service shall cause the connection associated with an instance of the 
Connection Configuration object to close. If the Close_Connection service is addressed to the 
class (instance 0), then all connection instances shall be closed. If addressed to the instance 
level, then only the specified instance shall be closed. The Close_Connection service shall 
initiate a “graceful” connection shutdown, that is, a Forward_Close request shall be sent to the 
connection target. Once a connection has been closed by this service it shall remain closed 
until an Open_Connection service is issued. 


Stop_Connection (Service Code 0x4E) 


The Stop_Connection service shall cause the connection associated with an instance of the 
Connection Configuration object to stop producing data immediately without sending a 
Forward_Close request to the connection target. If the Stop_Connection service is addressed to 
the class (instance 0), then all connection instances shall be stopped. If addressed to the 
instance level, then the specified instance shall be stopped. Once a connection has been 
stopped, it remains stopped until a subsequent Open_Connection service request is issued. 


Change_Start (Service Code 0x4F) 
This service shall: 


e signal the beginning of an edit session; 

e synchronize the current and pending attributes; 
e place all connections in the "changeable" state; 
e start the edit watchdog timer. 


Change_Start shall be requested prior to performing any services that modify the attributes of a 
connection. This service shall only be addressed to the class-level (instance 0). If a 
Change_Start service is received while an edit session is active, an Object State Conflict error 
(O0x0C) shall be returned. 


This service supports the following error codes in addition to other error codes listed in 
Appendix B: 


Table 5-48.19 Change_Start Service Request Error Codes 


Extended se 
General Status Error Name Description 
Status 


0x0C Object State conflict An edit session is already active 


0x10 None Device State conflict The device is in a state that prevents starting an 
edit session 


Get_Status (Service Code 0x50) 


The Get_Status service shall retrieve the status attribute (attribute 1) for multiple connections 
via a single transaction. This service shall be supported at the class-level (instance 0) only. 
Given a starting instance number, the Get_Status service shall return instance/status pairs until 
either the response buffer is full or the status of all connections has been returned. 
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The following request parameter is defined: 


Table 5-48.20 Get_Status Service Parameter 


Parameter Data Type Description 
Starting Instance UDINT Starting instance number 


The following response parameters are defined for this service: 


Table 5-48.21 Get_Status Service Response 


Parameter Data Type Description 


Done Indicator UINT 0 = More status to be retrieved 
1 = All connection status information has been retrieved. 
All other values reserved. 


NumStatusEntries | UINT Number of instance/status pairs that follow. 


StatusEntries Array of List of instance/status pairs 
Struct of 


UDINT Connection Configuration instance number 
USINT General status 

USINT Reserved, shall be 0 

UINT Extended status 


This service supports the following error codes in addition to other error codes listed in 
Appendix B: 


Table 5-48.22 Get_Status Service Errors 


General Extended 
Status Status 


0x03 Invalid Parameter Value The attribute count is invalid 
5-48.4.13 Change_Complete (Service Code 0x51) 


This service shall signal the completion of an edit session. Pending attributes for all modified 
connection instances shall be applied. This service shall take a parameter indicating the type of 
change being performed; either full or incremental. If an incremental edit is specified, then only 
the connections that have been modified shall be broken and re-established. If a full edit is 
specified, then all connections shall be broken and all supporting resources shall be freed and 
reallocated before attempting to re-establish the connections. The Change_Complete service 
shall be supported at the class-level (instance 0) only. 


Error Name Description 


If optional instance attribute 12 is supported and the value of instance attribute 12 is FALSE or 
if optional instance attribute 12 is not supported an attempt to open the connection shall be 
made. If optional instance attribute 12 is supported and the value of instance attribute 12 is 
TRUE, no attempt shall be made to open the connection. 


The following request parameter is defined: 
Table 5-48.23 Change_Complete Service Parameter 


Parameter Description 


0 = Full 
1 = Incremental 
All other values reserved. 


Change Type 


This service supports the following error codes in addition to other error codes listed in 
Appendix B: 
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| Table 5-48.24 Change_Complete Service Errors 


General Extended cere 
Error Nam Descr m 
| 0x02 None Resource unavailable Indicates that there is not enough memory on 
the host device to support the specified 
configuration. 


| 0x0C Object State conflict An edit session is not active 
0x10 None Device state conflict The device is in a state that prevents 
completing an edition session 
5-48.4.14 Audit_Changes (Service Code 0x52) 


This service shall verify whether or not there is enough memory on the host device to support a 
proposed configuration. Like the Change_Complete service, this service shall take a parameter 
indicating the type of change being performed; either full or incremental. The Audit_Changes 
service shall be supported at the class-level (instance 0) only. This service allows a 
configuration client to determine if all pending changes will be successful before actually 
committing the changes with the Change_Complete service. 


The following request parameter is defined: 


Table 5-48.25 Audit_Changes Service Parameter 


UINT 


Parameter Description 


Change Type 


0 = Full 
1 = Incremental 
All other values reserved. 


This service supports the following error codes in addition to other error codes listed in 
Appendix B: 


Table 5-48.26 Audit_Changes Service Errors 


| Seecal Bxtcoied Error Name Description 
Status Status P 
0x02 None Resource Indicates that there is not enough memory on the host 
unavailable device to support the specified configuration. 
0x0C None Object State An edit session is not active 
conflict 


0x10 None Device state The device is in a state that prevents completing an 
conflict audit 
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5-48.5 Behavior 
The flowchart below summarizes the process of creating, editing, and deleting connections. 


Figure 5-48.1 Connection Configuration Object Edit Flowchart 
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6-1 


6-2 


Introduction 


To provide interoperability and promote interchangeability by like device types, there must be 
some consistency between devices of the same type. That is, there must be a core “standard” 
for each device type. In general, like devices must: 


e exhibit the same behavior 
e produce and/or consume the same basic set of I/O data 
e contain the same basic set of configurable attributes 


The formal definition of this information is known as a device profile. This chapter provides a 
detailed definition of a device profile and describes its components. 


A device profile shall contain: 


e an object model for the device type 


e the I/O data format for the device type configuration data and the public interface(s) to that 
data 


You may adopt or extend one of the existing profiles in this chapter or you may define your 
own profile based on the format contained in this chapter. 


The Object Model 


To provide interoperability among like devices, the same object implemented in two or more 
devices shall behave identically from device to device. Consequently, each object specification 
includes a rigid definition of behavior. 


Every CIP product contains several objects. These objects interact to provide basic product 
behavior. Because the behavior of individual objects is fixed, the behavior of identical 
groupings of objects is also fixed. Therefore, the same group of objects arranged in a specified 
order will interact to produce the same behavior from device to device. 


The grouping of objects used in a device is referred to as that device’s object model. See Figure 
6-2.1. For like devices to produce identical behavior, they must have identical object models. 
Therefore, an object model is included with every device profile to provide for interoperability 
among like CIP devices. 
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Figure 6-2.1 Object Model 
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An object model specification: 


CIP Network 


e Identifies all object classes present in the device (required, optional and conditional). 


e Indicates the number of instances present in each object class. If the device supports the 
dynamic creation and deletion of instances, then the object model states the maximum 
number of instances that can exist within the object class. 


e States whether or not the object affects behavior of the device. If it does affect behavior, 
the object model states how. 


e Defines the interface to each object. This defines how objects and object classes are linked. 


6-2.1 All Objects Present in a Device 


Every device can contain both required objects, optional, and conditional objects. When an 
object is identified as “required,” it is required for all devices of that type. Each device profile 
shall contain an Object Interface Table, which shall list the interface to each object. At a 
minimum, every object model for a CIP common device must specify instances of these object 
classes: 
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Table 6-2.2 Minimum Objects Required For All Devices 


Object Class # of Instances 
Network 
fe 
Object(s) 
2 (explicit 0) 

1 


Required if CIP network type is DeviceNet 
Required if CIP network type is EtherNet/IP 
Required if CIP network type is ControlNet 
Required if CIP network type is CompoNet 
If CIP network type is CompoNet, see Chapter 6 of Volume 6, CompoNet Adaptation of CIP 


ee ee ee ee 


OBRWNe 


Although not an object, each device shall also support the Unconnected Message Manager 
(UCMM). In addition to these minimum object classes, object models can, and probably will, 
contain application—specific object classes that are required by the device type. 


Some object classes may be included that provide functions beyond the minimum required of a 
particular device type or that have no effect on device behavior. These types of objects are 
identified in the profile as “optional” or “conditional.” When an object is identified as 
“optional,” it is optional for all devices of that type. The device type dictates what objects are 
necessary to provide the device’s required basic function. When an object is identified as 
“conditional,” it is required “if” a specified condition exists. The Device Profile shall specify 
the conditions. 


Important: Instances of OPTIONAL object classes may provide behavior beyond the behavior 
defined for the device type. At power up, however, this additional behavior 

shall default in a manner such that the device’s behavior appears to be identical to the basic 
behavior defined for that device type. 


Table 6-2.3 Required/Optional Object Criteria 


Object classes are specified as Object classes are specified as 
REQUIRED when they OPTIONAL when they 


affect in any way the basic behavior specified for 
the device type 


provide behavior beyond the minimum specified 
for the device type 


are used to define the I/O data format of the device | provide functions beyond the minimum required of 
a particular device type or have NO effect on 


behavior of the device 


provide the primary method of access to the 
device’s configuration data 


provide an optional method of access to the 
device’s configuration data. 
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6-2.2 


6-2.3 


Objects That Affect Behavior 


After all objects included in the device are identified, this section of a profile distinguishes 
between objects that do and do not affect the behavior of the device. If an object affects 
behavior, this section states how. Any component (object, attribute, or service) that affects the 
behavior of a device is specified here. The following table shows the format of this part of the 
device profile description. 


Table 6-2.4 Components That Affect Behavior of the Device 


Component Effect on behavior 
Attribute/Object Behavior 


Object Interfaces 


The final portion of the object model specification within a device profile is the definition of all 
interfaces to each of the device’s internal objects. Defining object interfaces indicates how the 
objects within a device are connected. 


Table 6-2.5 Object Interfaces 


Object 
Name of Object 


Interface 


Name of Interface (Explicit Messaging Connection 
Instance, Message Router, I/O connection) 


In summary, an object model defines behavior of a device in the following terms: 


e objects present in device 
e maximum number of object instances 
e how objects affect behavior 


e object interfaces 


1/O Data Format 


This section of a profile defines how a device communicates on the CIP network, which 
includes an exact specification of the device’s I/O data format. 


Smart networked devices can (and probably will) produce and/or consume more than one I/O 
value. Typically, they will produce and/or consume one or more I/O values, as well as status 
and diagnostic information. Each piece of data communicated by a device is represented by an 
attribute of one of the device’s internal objects. 


Communicating multiple pieces of data (attributes) across a single I/O connection requires that 
the attributes be grouped or assembled together into a single data block. Instances of the 
Assembly Object Class perform this grouping. Thus, the definition of a device’s I/O data 
format is equivalent to the definition of the assembly instances used to group the device’s I/O 
data. 
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6-3.1 


6-3.2 


6-3.3 


In a device profile, the I/O data format of devices adheres to these guidelines: 


e I/O Assemblies are either Input type or Output type 


e A device may contain more than one I/O assembly (data format of I/O instances may be a 
configurable option of your device) 


The definition of a device’s I/O assembly instances: 
e Identifies the I/O assembly by instance number, type, and name 
e Specifies the I/O assembly Data attribute format 


e Maps the I/O assembly Data attribute components to other attributes 
1/O Assembly Instances 


Because CIP products can contain one or more I/O assemblies (of either Input type or Output 
type), assembly instances are clearly identified for each device type. The following table 
identifies the I/O assembly instance supported by a typical device. 


Table 6-3.1 Identifying I/O Assembly Instances 


Number Type Name 


Assembly # Input or Output | Name of assembly 


Format of I/O Assembly Data Attribute 


Any device communicating I/O data to and from another device must have knowledge of the 
other device’s I/O data format. The Data attribute of the Assembly Object (instance attribute 
#3) holds this I/O format. Therefore, this section of a profile specifies the format of the Data 
attribute for each assembly instance listed in the assembly instance identification table. 


The Data attribute is an array of bytes. The device profile specifies how that array is defined to 
represent a device’s I/O data. 


Specification of the I/O assembly Data attribute format adheres to these guidelines: 
e List Data components that are larger than one byte in size with the low-order byte first 


e Right justify within a byte (starting with bit 0) Data components that are smaller than one 
byte 


e Explicitly state if bits or bytes are to be reserved 
Map of I/O Assembly Data Attribute Components 


Because components of the Assembly Object’s Data attribute are attributes of other objects, a 
device profile contains a mapping of those attributes to their respective objects. 
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The map includes specification of the member path (Class ID, Instance ID, etc.) for each data 
component. Specification of the relative addresses of each Data attribute component is 
essentially equivalent to specification of the Member_List instance attribute (#2) of the 
Assembly Object. 


The following table shows the format for an I/O assembly Data attribute mapping. 


Table 6-3.2 Example I/O Assembly Data Attribute Mapping 


Data Component Instance Data Type 


Component name | Component class XXhex Component 
within profile name within attribute name 
object library within object 
library 


If a device has more than one I/O assembly instance, the profile should include a table similar 
to the one above for each I/O assembly instance. 


Device Configuration 


In addition to a product’s object model and format of its I/O data, a device profile includes 
specification of the device’s configurable parameters and the public interface to those 
parameters. 


The configurable parameters in a device directly affect its behavior. Because like devices must 
behave in an identical fashion, they must have identical configuration parameters. 


Important: “Identical configuration” refers to basic configuration. A device may have 
extended functionality (with associated parameters) that is beyond the behavior defined for the 
device type. At power up, this functionality must default in a manner such that the device’s 
behavior appears to be identical to the behavior defined for that device type. 


In addition to defining identical configuration parameters, the public interfaces to those 
parameters must be identical. 


Definition of a device’s configuration includes the following information for each configurable 
attribute: 
e configuration parameter data: 
e all attribute values of each Parameter Object Instance 
e all values in the parameter section of an Electronic Data Sheet 
e at minimum, the following printed data sheet information: 
e parameter name 
e attribute path (class, instance, attribute) 
e data type 
e parameter units 


e minimum/maximum default values 
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6-4.1 


6-4.2 


6-4.3 


e effect of parameters on device behavior 


e parameter groups if any configurable parameters are grouped using an instance of the 
Parameter Group Object Class 


e public interface to the device’s configuration (i.e., bulk configuration via a configuration 
assembly, full/stub instances of the Parameter Object Class, etc.) 


Parameter Data 
The definition of each configuration parameter includes specification of one of the following: 


e the instance attributes of an instance of the Parameter Object Class (for each of your 
configuration parameters) 


e all data outlined in the parameter section of an EDS 
e at minimum, the following printed data sheet information: 
e parameter name 
e attribute path (class, instance, attribute) 
e data type 
e parameter units 


e minimum/maximum default values 
Effect of Configuration Parameters on Behavior 


The effect that each of the configuration parameters has on the device’s behavior is also 
documented in the configuration section of a device profile. The following table shall be used 
within the device profile. 


Table 6-4.1 Example of Table Showing the Effect of Parameters on Behavior 


Parameter Effect on Behavior 


Parameter name Effect 
Parameter Groups 


If any configurable parameters are grouped using an instance of the Parameter Group Object 
Class, then the definition of each group is specified in this section. 


The definition of each configuration parameter group includes specification of either: 


e the instance attributes of an instance of the Parameter Group Object Class (for each of your 
configuration parameters); or 


e all data outlined in the parameter group section of an EDS 
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6-4.4 


6-4.4.1 


6-4.4.2 


Public Interfaces to Device Configuration Data 


The final portion of the configuration section of a profile clearly specifies the public 
interface(s) to a device’s configuration data. 


Parameter Object 


If a device employs instances of the Parameter Object Class, each instance and the 
configuration parameter associated with it is specified here. Also included here is a map of the 
configuration parameter to the object in which it is contained. 


Table 6-4.2 Parameter Instance Listing 


Instance Number Configuration Parameter Name 


xX Parameter name 


Table 6-4.3 Configuration Parameter Mapping 
Parameter Name | Name | | Number | Number | Name | | Number | 


Configuration Assembly Object 


Documentation of a device’s configuration assembly provides information similar to that which 
is specified for the device’s I/O assemblies. This section of a profile includes: 


e specification of the configuration assembly Data attribute format 
e mapping of each configurable attribute using its logical address (Class/Instance/Attribute) 


Specification of the configuration assembly Data attribute format adheres to these guidelines: 


e List Data components that are larger than one byte in size with the low-order byte first 


e ~=Right justify within a byte (starting with bit 0) Data components that are smaller than one 
byte 


e Explicitly state if bits or bytes are to be reserved 


The table below shows how the format of the Configuration Assembly Object’s Data attribute 
is specified. 


Table 6-4.4 Configuration Assembly Data Attribute Format 


Pee [oo | ae [oe | 


Configuration Parameter 3 


In addition to specification of the device’s configuration assembly Data attribute format, this 
section also includes a mapping of the individual configuration assembly Data attribute 
components to their respective objects. 
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6-5 


The map includes specification of the Class, Instance, and Attribute IDs for each data 
component. Specification of the relative addresses of each Data attribute component is 
essentially equivalent to specification of the Member_List instance attribute (#2) of the 
Assembly Object. The table below shows the format for the configuration assembly Data 
attribute mapping. 


Table 6-4.5 Configuration Assembly Data Attribute Mapping 


Configuration Class XXhex y Range Z 
Parameter1 


Extended Device Profiles 


You have the option of adopting existing device profiles and then extending them to 
incorporate any additional behavior your product may exhibit. 


Manufacturers of multiple source products may wish to design a product such that it provides 
the basic behavior defined in the product’s device profile and, in addition, provides extended 
functionality that helps distinguish one product from another. 


Important: The basic device profile definition must not change when extending an existing 
device profile. Also, the added functionality must not make the extended profile incompatible 
with the basic device profile. For these reasons, you must adhere to the following rules when 
extending an existing device profile: 


All new objects, attributes, and services added to the profile are OPTIONAL. Backwards 
compatibility shall be maintained. 


At power-up, all new behavior must default such that the device’s behavior appears 
identical to the specified default behavior defined for the device type. 


The basic I/O format must not change. Extended I/O formats can be provided for by adding 
optional I/O assembly instances. 


The basic configuration must not change. Extended configuration parameters can be 
provided for by adding optional configuration assembly instances or optional instances of 
the Parameter Object Class. 


Any additional assembly instances must be defined in the vendor—specific address range. 


Important: Instances of the Assembly Class are divided into address ranges to provide for 
extensions to device profiles. See the Assembly Object definition in the object library. 
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6-6 Device Profile Numbering Scheme 


The table below reveals the numbering scheme to be used for device profile numbering. The 
table shows that a device profile may be either publicly defined or vendor specific: 


Table 6-6.1 Device Profile Numbering 


Type Range Quantity 
Publicly Defined OOhex - S3hex 100 
Vendor Specific 64hex - C7hex 100 
Reserved by CIP C8hex - FFhex 56 
Publicly Defined 100pex - 2FFhex 512 
Vendor Specific 300hex - 4FFhex 512 
Reserved by CIP 500hex - FFFFhex 64,256 


While you are highly encouraged to adopt or develop a device profile for your product you 
may be unwilling or unable to do so. For this reason ranges of device type numbers have been 
set aside for ’Vendor Specific” device profiles. If you choose to use one of these device type 
numbers you are not required to publish a device profile for your product. It is important to 
note, however, that if you do not publish your device’s profile, your customers will not be able 
to find direct replacements for your product and, more importantly, they will not be able to use 
your product as a direct replacement for your competitor’s product. Additionally, even vendor 
specific device profiles are required to support the minimum objects listed in section 6-2.1. 


— 6-20 —- 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 6: Device Profiles, Part 1 


Device Profiles 


The remainder of this chapter contains listings of all existing device profiles at the time of 
publication. 


Table 6-7.1 Device Profiles in This Chapter 


For information about: Go to page: 
AC Drives 6-56 


Go to section: Device Type Number: 
6-15 O2nex 


Barcode Scanner 6-70 6-17 Not yet assigned 


Modbus Device See Volume 7, Integration of 28hex 


Modbus Devices in the CIP 
Architecture 


CIP Motion Drive 6-249 6-41 25hex 


Circuit Breaker 6-115 


> 
on 
oo 


6-25 Not yet assigned 


Communications Adapter 6-13 OChex 
CompoNet Repeater 26hex 

Adaptation of CIP 
Contactor 15hex 
Control Station Not yet assigned 
ControlNet Physical Layer 32hex 
Component 
Programmable Logic Controller OEhex 
DC Power Generator 1Fhex 
Fluid Flow Controller 24nex 
General Purpose Analog I/O 6-55 Not yet assigned 
General Purpose Discrete I/O 6-37 O7hex 
Generic Device | 623d BC O0hex 
Human-Machine Interface 18hex 
Inductive Proximity Switch OShex 
Limit Switch | 625 | O4pex 
Mass Flow Controller 1Ahex 
Mass Flow Controller, Enhanced 27 hex 
Message Display Not yet assigned 
Motor Overload 6-94 O3hex 
Motor Starter 16hex 
Photoelectric Sensor 6-33 O6pex 
Pneumatic Valve(s) 1Bhex 
Position Controller 10hex 
Process Control Valve 1Dhex 
Residual Gas Analyzer 1Ehex 
RF Power Generator 20hex 
Safety Discrete I/O Device 23hex 
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For information about: Device Type Number: 
Servo Drives | 669 | 616 Not yet assigned 
Softstart Starter 17hex 
Turbomolecular Vacuum Pump 2Ihex 
Weigh Scale Not yet assigned 
Vacuum Pressure Gauge 1Chex 


The following device type numbers have been obsoleted. 


Table 6-7.2 Obsolete Device Profiles 


Obsoleted Device Type Number | Previous Profile Assignment 


Olhex Control Station 
O8hex Encoder 
OAhex General Purpose Analog I/O 
ODhex Barcode Scanner 
11hex Weigh Scale 
12hex Message Display 
14hex Servo Drives 
19hex Pneumatic Valve(s) 
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Generic Device, Type: 00pex 


6-8 Generic Device 
Device Type: 00 Hex 


The Generic Device type defines a device that does not fit into any of the defined device types. 
Initially, there will probably be many Generic Device type devices, but over time, Open 
DeviceNet Vendor Association, Inc. and ControlNet International Special Interest Groups 
(SIGs) will create a specific device profile for devices with similar functionality. The Generic 
Device type devices are not interchangeable. 


6-8.1 Object Model 


The Object Model in Figure 6-8.1 represents the minimum support in a Generic Device. The 
table below indicates: 


e the object classes present in this device 
e whether or not the class is required 
e the number of instances present in each class 


Table 6-8.1 Objects Present in a Generic Device 


Object Class # of Instances 
CIP Common Required Objects See Section 6-2.1 
Assembly at least 1 
Application at least 1 


The Generic Device profile does not specify any instances of the Assembly Object or the type 
of application objects necessary for device operation. This portion of the device profile must be 
supplied by the product developer as described in Section 6-1 through 6-7 inclusive. The 
Generic device profile shall be unique among the “open” device profiles in permitting the use 
of Assembly object instances in the open range. 


Figure 6-8.2 Object Model for the Generic Device 
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Generic Device, Type: 00pex 


6-8.2 How Objects Affect Behavior 


The objects for this device affect the device’s behavior as shown in the table below. 


Table 6-8.3 Object Effect on Behavior 


Object 
CIP Common Required | See Section 6-2.2 for details. 


Effect on behavior 


Assembly Defines input/output and configuration data format 


Application Defines device operation 


6-8.3 Defining Object Interfaces 


The objects in the Generic Device have the interfaces listed in the following table: 


Table 6-8.4 Object Interfaces 


Object 
CIP Common Required 


Interface 
See Section 6-2.3 for details. 
Assembly 1/O Connection or Message Router 


Application Assembly or Message Router 
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6-9 Limit Switch Device 
Device Type: 04 Hex 


A limit switch mechanically detects the presence or absence of a physical target object. The 
switch detects an object when a lever or rod makes physical contact with the object. 


6-9.1 Object Model 


The Object Model in Figure 6-9.2. represents a limit switch. The table below indicates: 


e the object classes present in this device 
e whether or not the class is required 
e the number of instances present in each class 


The CIP Object Library provides more details about these objects. 


Table 6-9.1 Objects Present in a Limit Switch 


Object Class 
CIP Common Required Objects 
Assembly 


Parameter 


Presence Sensing 


Figure 6-9.2 Object Model for a Limit Switch 


Application Object 


Presence Sensing 


one Identity Object 
Object 
Assembly Object 


Co) Manager or 


Connection Object 


Network Specifi 
Link Object(s 


CIP Network 


a> Optional Object 


— 6-25 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 6: Device Profiles, Part 1 


Limit Switch Device, Type: 044. x 


6-9.2 How Objects Affect Behavior 
The objects for this device affect the device’s behavior as shown in the table below. 


Table 6-9.3 Object Effect on Behavior 


Object Effect on behavior 
CIP Common Required | See Section 6-2.2 for details. 
Assembly Defines I/O data format 
Parameter Provides a public interface to the device’s configuration data 
Presence Sensing Affects Output Value (attribute) 


6-9.3 Defining Object Interfaces 
The objects in this device have the interfaces listed in the following table: 


Table 6-9.4 Object Interfaces 


Object Interface 
CIP Common Required | See Section 6-2.3 for details. 
Assembly I/O Connection or Message Router 
Parameter Message Router 
Presence Sensing Message Router, Assembly Object, or Parameter Object 


6-9.4 1/O Assembly Instances 


The following table identifies the I/O assembly instance supported by the limit switch. 


Table 6-9.5 I/O Assembly Instances 


Number Type Name 


6-9.5 1/O Assembly Data Attribute Format 
The I/O Assembly data attribute has the format shown below. 


Table 6-9.6 I/O Assembly Data Attribute Format 


fo [Reserved [Reserved | Reserved | Reserved | Reserved | Reserved | Diagnostic |Oupur 


Instance 
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6-9.6 Mapping I/O Assembly Data Attribute Components 


The following table indicates the I/O assembly Data attribute mapping for this limit switch 
device. 


Table 6-9.7 I/O Assembly Data Mapping 


Data Component Class Instance Attribute 
Name Name Number Number Number 


6-9.7 Defining Device Configuration 


Public access to the Presence Sensing Object by the Message Router must be supported for 
configuration of this device type. If supported, the optional Parameter Object may be used to 
access the device type’s configuration parameter. 


6-9.7.1 Parameter Object Instances 


The limit switch contains one instance of the Parameter Object Class. This instance is a 
Parameter Object stub. See The CIP Object Library for the definition of the Parameter Object 
and an explanation of how it is used for configuration. 


The following table identifies the Parameter Object instance supported by the limit switch. 


Table 6-9.8 Parameter Object Instances Supported 


Number Name 


1 Operation Mode Configuration 
6-9.7.2 Mapping Parameter Object Data 
The following table indicates the Parameter Object data mapping for the limit switch device. 


Table 6-9.9 Parameter Object Data Mapping 


Configuration Parameter Instance Attribute 
Operate Mode Configuration __| presence sensing Operate Mode 
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Limit Switch Device, Type: 044. x 


6-9.7.3 Configuration Parameter Definitions 


The following sections of an example EDS show the information necessary to define the 
configuration parameters for a limit switch. 


[Params ] 
Parami= $Operate Mode 
0, $Data Placeholder 
2,”20 Oe 24 01 30 08”, $Path size and Path to Operate Mode Attr 
©x0002, $Descriptor (support enumerated strings 
©xC1,1 $Data Type and Size (Boolean) 
"Operate Mode”, $Name 
ae $Units (not used) 
Mee g$User Manual Ref (not used) 
0,1,0, $min, max, default values 
0,0,0,0, $mult, div, base, offset scaling (not used) 
0,0,0,0, $mult, div, base, offset links (not used) 
1; $decimal places 

[EnumPar ] 
Parami= $Operate Mode Enumerated Strings 
"Normally Open”, $For value=0 
"Normally Closed”; $For value=1 

6-9.8 Effect of Configuration Parameters on Behavior 


The configuration parameter affects the device’s behavior as shown below. 


Table 6-9.10 Configuration Parameter Effect on Behavior 


Parameter Effect on Behavior 


Operate Mode Inverts the level defined for the Output attribute of the Presence Sensing Object 
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Inductive Proximity Switch Device, Type: 05x 


6-10 Inductive Proximity Switch Device 
Device Type: 05 tex 


An inductive proximity switch operates in an electromagnetic field. When it senses a change in 
the field, it sends a signal to an output amplifier circuit to change the state of the circuit. 


6-10.1 Object Model 


The Object Model in Figure 6-10.2 represents an inductive proximity switch. The table below 
indicates: 


e the object classes present in this device 
e whether or not the class is required 
e the number of instances present in each class 


The CIP Object Library provides more details about these objects. 


Table 6-10.1 Objects Present in an Inductive Proximity Switch 


Object Class # of Instances 
CIP Common Required Objects See Section 6-2.1 
Parameter 1 
Presence Sensing 1 


Figure 6-10.2 Object Model for an Inductive Proximity Switch 
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6-10.2 How Objects Affect Behavior 


The objects for this device affect the device’s behavior as shown in the table below. 


Table 6-10.3 Object Effect on Behavior 


Object Effect on behavior 
CIP Common Required | See Section 6-2.2 for details. 
Assembly Defines I/O data format 
Parameter Provides a public interface to the device’s configuration data 
Presence Sensing Effects Output Value (attribute) 


6-10.3. Defining Object Interfaces 
The objects in this device have the interfaces listed in the following table: 


Table 6-10.4 Object Interfaces 


Object Interface 
CIP Common Required | See Section 6-2.3 for details. 
Assembly I/O Connection or Message Router 
Parameter Message Router 
Presence Sensing Message Router, Assembly Object, or Parameter Object 


6-10.4 I/O Assembly Instances 


The following table identifies the I/O assembly instance supported by the inductive proximity 
switch. 


Table 6-10.5 I/O Assembly Instances 


Number Type Name 


6-10.5 I/O Assembly Data Attribute Format 


The I/O Assembly data attribute has the format shown below. 


Table 6-10.6 I/O Assembly Data Attribute Format 
o_o eet vd [een ere eet gic 


Instance 
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6-10.6 


6-10.7 


6-10.7.1 


6-10.7.2 


Inductive Proximity Switch Device, Type: 05x 


Mapping I/O Assembly Data Attribute Components 


The following table indicates the I/O assembly Data attribute mapping for this inductive 
proximity switch device. 


Table 6-10.7 I/O Assembly Data Mapping 


Name | Number | Number Name 


a ce 
ssc Seing [OF [1 [Owe 


Defining Device Configuration 


Data Component Attribute 


Name Number 


Diagnostic 


Output 


Public access to the Presence Sensing Object by the Message Router must be supported for 
configuration of this device type. If supported, the optional Parameter Object may be used to 
access the device type’s configuration parameter. 


Parameter Object Instances 


The following table identifies the Parameter Object instance supported by the inductive 
proximity switch. 


Table 6-10.8 Parameter Object Instances Supported 


Number Name 


1 Operation Mode Configuration 


Mapping Parameter Object Data 


The following table indicates the Parameter Object data mapping for the inductive proximity 
switch device. 


Table 6-10.9 Parameter Object Data Mapping 


Configuration Parameter 


Name 


Instance Attribute 


Operate Mode Configuration _| Presence Sensing 
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6-10.7.3 Configuration Parameter Definitions 


The following sections of an example EDS show the information necessary to define the 
configuration parameters for an inductive proximity switch. 


[Parms ] 
Parami= $Operate Mode 
0, $Data Placeholder 
3,”20 Oe 24 01 30 08”, $Path size and Path to Operate Mode Attr 
©x0002, $Descriptor (Support enumerated strings) 
©xC1,1 $Data Type and Size (Boolean) 
"Operate Mode”, $Name 
ae $Units (not used) 
Mee g$User Manual Ref (not used) 
0,1,0, $min, max, default values 
0,0,0,0, $mult, div, base, offset scaling (not used) 
0,0,0,0, $mult, div, base, offset links (not used) 
1; $decimal places 

[EnumPar ] 
Parami= $Operate Mode Enumerated Strings 
"Normally Open”, $For value=0 
"Normally Closed”; $For value=1 


6-10.8 Effect of Configuration Parameters on Behavior 
The configuration parameter affects the device’s behavior as shown below. 


Table 6-10.10 Configuration Parameter Effect on Behavior 


Parameter Effect on Behavior 


Operate Mode Inverts the level defined for the Output attribute of the 


Presence Sensing Object 
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6-11 Photoelectric Sensor Device 
Device Type: 06 Hex 


A photoelectric sensor electrically senses the presence or absence of a target object or part of a 
machine. Typical applications include assembly, packaging, and material handling. 


6-11.1 Object Model 


The Object Model in Figure 6-11.2 represents a photoelectric sensor. The table below indicates: 


e the object classes present in this device 
e whether or not the class is required 
e the number of instances present in each class 


The CIP Object Library provides more details about these objects. 


Table 6-11.1 I/O Objects Present in a Photoelectric Sensor 


Object Class Optional/Required # of Instances 


CIP Common Required Objects See Section 6-2.1 
Assembly 1 
Parameter 1 
Presence Sensing 1 


Figure 6-11.2 Object Model for a Photoelectric Sensor 
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6-11.2 How Objects Affect Behavior 


The objects for this device affect the device’s behavior as shown in the table below. 


Table 6-11.3 Object Effect on Behavior 


Object Effect on behavior 
CIP Common Required | See Section 6-2.2 for details. 
Assembly Defines I/O data format 
Parameter Provides a public interface to the device’s configuration data 
Presence Sensing Affects output value 


6-11.3 Defining Object Interfaces 
The objects in this device have the interfaces listed in the following table: 


Table 6-11.4 Object Interfaces 


Object Interface 
CIP Common Required | See Section 6-2.3 for details. 
Assembly I/O Connection or Message Router 
Parameter Message Router 
Presence Sensing Message Router, Assembly Object, or Parameter Object 


6-11.4 I/O Assembly Instances 


The following table identifies the I/O assembly instance supported by the photoelectric sensor. 


Table 6-11.5 I/O Assembly Instances 


Number Type Name 


6-11.5 I/O Assembly Data Attribute Format 
The I/O Assembly data attribute has the format shown below. 


Table 6-11.6 I/O Assembly Data Attribute Format 


Instance | Byte| Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
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6-11.7 


6-11.7.1 


6-11.7.2 


Photoelectric Sensor Device, Type: 06y¢x 


Mapping I/O Assembly Data Attribute Components 


The following table indicates the I/O assembly Data attribute mapping for this photoelectric 
sensor device. 


Table 6-11.7 I/O Assembly Data Mapping 


Data Component Instance eee 


Defining Device Configuration 


Public access to the Presence-Sensing Object by the Message Router must be supported for 
configuration of this device type. If supported, the optional Parameter Object may be used to 
access the device type’s configuration parameter. 


Parameter Object Instances 


The photoelectric sensor contains one instance of the Parameter Object Class. This instance is a 
Parameter Object stub. See Chapter 5, Object Library, for the definition of the Parameter 
Object and an explanation of how it is used for configuration. 


The following table identifies the Parameter Object instance supported by the photoelectric 
sensor. 


Table 6-11.8 Parameter Object Instances Supported 


Number Name 


1 Operation Mode Configuration 


Mapping Parameter Object Data 


Table 6-11.9 Parameter Object Data Mapping 


The following table indicates the Parameter Object data mapping for the photoelectric sensor 
Attribute 


device. 
Instance 


Configuration Parameter 


Name 


Operate Mode Configuration _| Presence Sensing 
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6-11.7.3 Configuration Parameter Definitions 


The following sections of an example EDS show the information necessary to define the 
configuration parameters for photoelectric sensor. 


[Parms ] 
Parami= $O0perate Mode 
0, $Data Placeholder 
2,”20 Oe 24 01 30 08”, $Path size and Path to Operate Mode Attr 
©x0002, $Descriptor (support enumerated strings 
©xC1,1 $Data Type and Size (Boolean) 
"Operate Mode”, $Name 
ae $Units (not used) 
Mee g$User Manual Ref (not used) 
0,1,0, $min, max, default values 
0,0,0,0, $mult, div, base, offset scaling (not used) 
0,0,0,0, $mult, div, base, offset links (not used) 
1; $decimal places 
[EnumPar ] 
Parami= $Operate Mode Enumerated Strings 
"Light Operate”, $For value=0 
"Dark Operate”; $For value=1 


6-11.8 Effect of Configuration Parameters on Behavior 
The configuration parameter affects the device’s behavior as shown below. 


Table 6-11.10 Configuration Parameter Effect on Behavior 


Parameter Effect on Behavior 


Inverts the level defined for the Output attribute of the 
Presence Sensing Object 


Operate Mode 
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6-12 General Purpose Discrete I/O Device 
Device Type: 07 Hex 


A General Purpose Discrete I/O device type interfaces to multiple discrete I/O device types that 
do not have network capabilities. Examples include sensors and actuators. 


6-12.1 Object Model 


The Object Model in Figure 6-12.2 represents a General Purpose Discrete I/O device. The table 
below indicates: 


e the object classes present in this device 
e whether or not the class is required 
e the number of instances present in each class 


The CIP Object Library provides more details about these objects. 


Table 6-12.1 Objects Present in the General Purpose Discrete I/O Device 


Object Class # of Instances 
CIP Common Required Objects See Section 6-2.1 
Discrete Input Group , 
Discrete Output Group 1 
Discrete Input Point * 
Discrete Output Point * 


* Depends on the level of I/O support provided by the product. 
** Required for input functions 
*** Required for output functions 
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Figure 6-12.2 Object Model for a General Purpose Discrete I/O Device 
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6-12.2 How Objects Affect Behavior 


The objects for this device affect the device’s behavior as shown in the table below. 


Table 6-12.3 Object Effect on Behavior 


Object Effect on behavior 
CIP Common Required | See Section 6-2.2 for details. 
Assembly Defines I/O data format and Output Configuration data format 
Discrete Input Point Defines behavior of the discrete input points for this device 
Discrete Input Group Stores the combined status of the Discrete Input Points 


Discrete Output Point Defines the behavior of discrete output points for this device 


Discrete Output Group | Defines the Idle and Fault actions of the discrete output points 
6-12.3 Defining Object Interfaces 
The objects in this device have the interfaces listed in the following table: 


Table 6-12.4 Object Interfaces 


Object Interface 
CIP Common Required | See Section 6-2.3 for details. 
Assembly I/O Connection or Message Router 
Discrete Input Group Message Router 


Discrete Output Group | Message Router 
Discrete Input Point Message Router 


Discrete Output Point | Message Router or Assembly Object 
6-12.4 I/O Assembly Instances 


The General Purpose Discrete I/O device I/O assemblies consist of: 


e six predefined input assemblies with single input status bits 

e one product-specific input assembly with a single input status bit 

e six predefined input assemblies with multiple input status bits 

e one product-specific input assembly with multiple input status bits 

e six predefined output assemblies 

e one product-specific output assembly 

e six predefined input assemblies with output status bits 

e one product-specific output status assembly 

e four input assemblies with multiple input status bits and multiple output status bits 


e nine input assemblies with a single input status bit and multiple output status bits 
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The following table identifies the I/O assembly instances supported by this device. 


Table 6-12.5 I/O Assembly Instances 


Number Type Name 
1 Input 1-Point Input with No Status Bit 
2 Input 2-Point Input with No Status Bit 
3 Input 4-Point Input with No Status Bit 
4 Input 8-Point Input with No Status Bit 
5 Input 16-Point Input with No Status Bit 
6 Input 32-Point Input with No Status Bit 
7 Input N-Point Input with No Status Bit 
11 Input 1-Point Input with Single Status Bits 
12 Input 2-Point Input with Single Status Bit 
13 Input 4-Point Input with Single Status Bit 
14 Input 8-Point Input with Single Status Bit 
15 Input 16-Point Input with Single Status Bit 
16 Input 32-Point Input with Single Status Bit 
17 Input N-Point Input with Single Status Bit 
21 Input 1-Point Input with Multiple Status Bits 
22 Input 2-Point Input with Multiple Status Bits 
23 Input 4-Point Input with Multiple Status Bits 

Input 8-Point Input with Multiple Status Bits 

25 Input 16-Point Input with Multiple Status Bits 
26 Input 32-Point Input with Multiple Status Bits 
27 Input N-Point Input with Multiple Status Bits 


31 Output 1-Point Output 
32 Output 2-Point Output 
33 Output 4-Point Output 
34 Output 8-Point Output 
35 Output 16-Point Output 
36 Output 32-Point Output 
37 Output N-Point Output 


41 Input 1-Point Output Status Bit 
42 Input 2-Point Output Status Bits 
43 Input 4-Point Output Status Bits 
44 Input 8-Point Output Status Bits 
45 Input 16-Point Output Status Bits 
46 Input 32-Point Output Status Bits 


N 
os 


47 Input N-Point Output Status Bits 
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Number Name 

52 2-Point Input with Single Input Status and Single Output Status Bits 

53 4-Point Input with Single Input Status and Single Output Status Bits 

54 8-Point Input with Single Input Status and Single Output Status Bits 

55 16-Point Input with Single Input Status and Single Output Status Bits 

56 32-Point Input with Single Input Status and Single Output Status Bits 

57 N-Point Input with Single Input Status and Single Output Status Bits 

62 ro | 2-Point Input with Multiple Input Status and Multiple Output Status 
Bits 

63 ee 4-Point Input with Multiple Input Status and Multiple Output Status 
Bits 

64 4 8-Point Input with Multiple Input Status and Multiple Output Status 
Bits 

65 4 16-Point Input with Multiple Input Status and Multiple Output Status 
Bits 

70 1-Point Input with Single Input Status and 1 Output Status Bit 

71 2-Point Input with Single Input Status and 1 Output Status Bit 

72 2-Point Input with Single Input Status and 2 Output Status Bits 

73 4-Point Input with Single Input Status and 2 Output Status Bits 

74 4-Point Input with Single Input Status and 4 Output Status Bits 

75 Input 8-Point Input with Single Input Status and 4 Output Status Bits 

76 fIinput 8-Point Input with Single Input Status and 8 Output Status Bits 

77 [Input -—_{ 16-Point Input with Single Input Status and 8 Output Status Bits 

78 input 16-Point Input with Single Input Status and 16 Output Status Bits 


I/O Assembly Data Attribute Format 


The I/O Assembly data attribute for the input data with no status bit has the format shown 
below. 


Table 6-12.6 I/O Assembly Data Attribute Format — Instances w/no Status Bit 

1 Reserved Discrete 
Input1 

2 Reserved Discrete Discrete 
Input2 Input 1 

3 Reserved Discrete | Discrete | Discrete Discrete 
Input4 Input3 Input2 Input1 

4 Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete Discrete 
Input8 Input7 Input6 Input5 Input4 Input3 Input2 Input1 
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5 Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete Discrete 
Input8 Input7 Input6 Input5 Input4 Input3 Input2 Input1 
1 Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete Discrete 
Inputl6 = |InputlS |Inputl4 |Inputl3 |Inputl2 |Inputl1 | Inputl0 Input9 
6 Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete Discrete 
Input8 Input7 Input6 Input5 Input4 Input3 Input2 Input1 
1 Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete Discrete 
Inputl6 = |InputlS | Inputl4 | Inputl3 |Inputl2 |Inputl1 | Inputld Input9 
2 Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete Discrete 
Input24 |Input23 | Input22 | Input21 |Input20 |Inputl9 | Inputl8 Input17 
Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete Discrete 
Input32 |Input31 |Input30 | Input29 |Input28 | Input27 | Input26 Input25 
7 Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete Discrete 
Input8 Input7 Input6 Input5 Input4 Input3 Input2 Input1 


reserved Discrete i Discrete 
Input Input 
N N-2 


The I/O Assembly data attribute for the input data with one status bit has the format shown 
below. 


Table 6-12.7 I/O Assembly Data Attribute Format — Instances w/one Status Bit 


1 Status Reserved Discrete 
Input1 

12 Status Reserved Discrete Discrete 
Input2 Input1 

13 a | bees Discrete | Discrete | Discrete Discrete 
eee Input3 Input2 Input1 


14 = Discrete | Discrete | Discrete | Discrete | Discrete | Discrete Discrete 
ae Input7 Input6 Input5 Input4 Input3 Input2 Input1 
pee |e 
15 | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete Discrete 
Input8 Input7 Input6 Input5 Input4 Input3 Input2 Input1 
Discrete |Discrete | Discrete | Discrete | Discrete | Discrete Discrete 
Inputl6 = |InputlS |Inputl4 |Inputl3 |Inputl2 | Inputl1 Input9 


Reserved 
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16 Discrete | Discrete | Discrete | Discrete | Discrete | Discrete Discrete 
Input8 Input7 Input6 Input5 Input4 Input3 Input1 


Discrete | Discrete | Discrete | Discrete | Discrete | Discrete Discrete 
Inputl6 = |InputlS |Inputl4 |Inputl3 |Inputl2 | Inputl1 Input9 


Discrete | Discrete | Discrete | Discrete | Discrete | Discrete Discrete 
Input24 |Input23 | Input22 |Input21 |Input20 | Inputl9 Input17 


Discrete | Discrete | Discrete | Discrete | Discrete | Discrete Discrete 
Input32 |Input31 |Input30 | Input29 | Input28 | Input27 Input25 


Reserved 


iy Discrete | Discrete | Discrete | Discrete | Discrete Discrete 
Input7 Input6 Input5 Input4 Input3 Input1 


Discrete Discrete 
Input Input 
N N-2 


The I/O Assembly data attribute for the input data with multiple status bits has the format 
shown below. 


Table 6-12.8 I/O Assembly Data Attribute Format — Instances w/multiple Status Bits 


22 Reserved Status2 Status1 Discrete Discrete 
Input2 Input1 

23 Status4 Status3 Status2 Status] Discrete | Discrete Discrete 
Input4 Input3 Input1 


24 Discrete Discrete | Discrete | Discrete | Discrete Discrete 
Input8 Input6 InputS Input4 Input3 Input1 


25 Discrete Discrete | Discrete | Discrete | Discrete Discrete 
Input8 Input6 InputS Input4 Input3 Input1 


Discrete | Discrete | Discrete | Discrete | Discrete | Discrete Discrete 
Inputl6 |InputlS |Inputl4 |Inputl3 |Inputl2 = | Inputl1 Input9 
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26 Discrete i Discrete | Discrete | Discrete | Discrete i Discrete 
Input8 Input6 InputS Input4 Input3 Input1 


Discrete Discrete 
—— ane 5 
4 |statuss | |e |stats 1 


Discrete i Discrete 
Input3 Input1 


27 Discrete i Discrete | Discrete | Discrete 


Input8 Input6 InputS Input4 


Status5 Status4 Status3 Status2 Status1 Discrete i Discrete 
oe Input 
N-2 


M Reserved Status Status Status 
N N-1 N-2 


The I/O Assembly data attribute for the output data has the format shown below. 


Table 6-12.9 /O — Data Attribute Format — ene Data ate 


Instance | Bits | | pits | Bit2 | Bit1 | Bito 
31 Reserved Discrete 
Output1 
32 Reserved Discrete Discrete 
Output2 Output1 
33 Reserved Discrete | Discrete i Discrete 
Output4 | Output3 Output1 
34 Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete Discrete 
Output8 |Output7 | Output6 | OutputS | Output4 | Output3 | Output2 Output1 


35 Discrete | Discrete | Discrete | Discrete | Discrete | Discrete i Discrete 
Output8 |Output7 | Output6 | OutputS | Output4 | Output3 Output1 
1 Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete Discrete 
Output16 | Output1S | Outputl4 | Output13 | Outputl2 | Output11 | OutputiO | Output9 
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Instance 


36 


37 


ane [ an? [we [oes [ana [oo | eo oe 


Discrete | Discrete 
Output8 | Output7 


Discrete | Discrete 
Output16 | Output15 


Discrete | Discrete 
Output24 | Output23 


Discrete | Discrete 
Output32 | Output31 


Discrete | Discrete 
Output8 | Output7 


reserved 


Discrete | Discrete 
Output6 | OutputS 


Discrete | Discrete 
Output14 | Output13 


Discrete | Discrete 
Output22 | Output21 


Discrete | Discrete 
Output30 | Output29 


Discrete | Discrete 
Output6 | Outputs 


Discrete 
Output4 


Discrete 
Output12 


Discrete 
Output20 


Discrete 
Output28 


Discrete 
Output4 


Discrete 
Output3 


Discrete 
Output11 


Discrete 
Output19 


Discrete 
Output27 


Discrete 
Output3 


Discrete 
Output 
N 


Bit 0 


Discrete 
Output1 


Discrete 
Output9 


Discrete 
Output17 


Discrete 
Output25 


Discrete 
Output1 


Discrete 


The I/O Assembly data attribute for the output data status bits has the format shown below. 


Table 6-12.10 I/O Assembly Data Attribute Format — Output Data Status Bits 


41 Reserved Discrete 
Output 
Status] 

42 Reserved Discrete Discrete 
Output Output 
Status2 Status] 

43 Reserved Discrete | Discrete | Discrete Discrete 
Output =| Output Output Output 
Status4 Status3 Status2 Status] 

44 Discrete | Discrete Discrete | Discrete Discrete | Discrete | Discrete Discrete 
Output Output Output Output Output —_| Output Output Output 
Status8 Status7 Status6 Status5 Status4 Status3 Status2 Status] 

45 Discrete | Discrete Discrete | Discrete Discrete | Discrete | Discrete Discrete 
Output Output Output Output Output =| Output Output Output 
Status8 Status7 Status6 Status5 Status4 Status3 Status2 Status] 

1 Discrete | Discrete Discrete | Discrete Discrete | Discrete | Discrete Discrete 
Output Output Output Output Output =| Output Output Output 
Status16 | Status15 Status14 | Status13 Status12 | Status11 | Status10 Status9 
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46 Discrete 
Output 
Status8 


Discrete 
Output 
Status16 


Discrete 
Output 
Status24 


Discrete 
Output 
Status32 


47 Discrete 
Output 
Status8 


Discrete 
Output 
Status7 


Discrete 
Output 
Status15 


Discrete 
Output 
Status23 


Discrete 
Output 
Status31 


Discrete 
Output 
Status7 


Discrete 
Output 
Status6 


Discrete 
Output 
Status14 


Discrete 
Output 
Status22 


Discrete 
Output 
Status30 


Discrete 
Output 
Status6 


Discrete 
Output 
Status5 


Discrete 
Output 
Status13 


Discrete 
Output 
Status21 


Discrete 
Output 
Status29 


Discrete 
Output 
Status5 


Discrete 
Output 
Status4 


Discrete 
Output 
Status12 


Discrete 
Output 
Status20 


Discrete 
Output 
Status28 


Discrete 
Output 
Status4 


Discrete 
Output 
Status3 


Discrete 
Output 
Status11 


Discrete 
Output 
Status19 


Discrete 
Output 
Status27 


Discrete 
Output 
Status3 


Discrete 
Output 
Status N 


Discrete 
Output 
Status2 


Discrete 
Output 
Status10 


Discrete 
Output 
Status18 


Discrete 
Output 
Status26 


Discrete 
Output 
Status2 


Bit 0 


Discrete 
Output 
Status] 


Discrete 
Output 
Status9 


Discrete 
Output 
Status17 


Discrete 
Output 
Status25 


Discrete 
Output 
Status] 


Discrete 
Output 


Status N-1 | Status N-2 


The I/O Assembly data attribute for the input data with one input status bit and one output 
status bit has the format shown below. 


Table 6-12.11 I/O Assembly Data Attribute Format — Assy with 1 Input & Output Status Bit 


Instance Bit 0 
52 Discrete Reserved Discrete 
Output Input1 
Status Status 
53 Discrete Reserved Discrete Discrete 
Input Output Input4 Input1 
Status Status 
54 Discrete Discrete Discrete 
Input7 Input4 Input1 
Discrete Reserved 
Output 
Status 
55 Discrete Discrete Discrete 
Input7 Input4 Input1 
Discrete | Discrete Discrete Discrete Discrete Discrete 
Input16 =| Input15 Input13 Input12 Input10 Input9 
2 Discrete | Discrete Reserved 
Input Output 
Status Status 
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56 Discrete Discrete Discrete 
Input7 Input4 Input1 


Instance Bit 0 


Discrete | Discrete Discrete Discrete Discrete Discrete 
Input16 =| Input15 Input13 Input12 Input10 Input9 


Discrete | Discrete Discrete Discrete Discrete Discrete 
Input24 | Input23 Input21 Input20 Input18 Input17 


Discrete | Discrete Discrete Discrete Discrete Discrete 
Input32 | Input31 Input29 Input28 Input26 Input25 


Discrete Reserved 
Output 
Status 


Discrete Discrete Discrete 
Input7 Input4 Input1 


Discrete Reserved Discrete 
Output Input 
Status Status N-2 


The I/O Assembly data attribute for the input data with multiple input status bits and multiple 
output status bits has the format shown below. 


Table 6-12.12 I/O Assembly Data Attribute Format — Assy w/Multiple Input & Output Status Bits 


Instance Bit 0 
62 Discrete Discrete Discrete 
Output Input Input1 
Status2 Status2 
63 Discrete | Discrete Discrete | Discrete Discrete Discrete 
Input Input Input Input Input4 Input1 
Status4 Status3 Status2 Status1 
Reserved Discrete Discrete 
Output Output 
Status4 Status] 
64 Discrete Discrete Discrete 
Input7 Input4 Input1 


Discrete | Discrete Discrete | Discrete Discrete | Discrete | Discrete Discrete 
Input Input Input Input Input Input Input Input 
Status8 Status7 Status6 Sta6tus5 Status4 Status3 Status2 Status] 


Discrete Discrete Discrete 
Output Output Output 
Status7 Status4 Status] 


— 6-47 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 6: Device Profiles, Part 1 
General Purpose Discrete I/O Device, Type: 07 ex 


Instance 


65 


Caer | eee [ees [mee [mes [| 


Discrete | Discrete Discrete | Discrete Discrete | Discrete | Discrete 
Input8 Input7 Input6 Input5 Input4 Input3 Input2 


Discrete 
Input16 


Discrete 
Input 
Status16 


Discrete 
Output 
Status16 


Discrete 
Input15 


Discrete 
Input 
Status7 


Discrete 
Input 
Status15 


Discrete 
Output 
Status7 
Discrete 
Output 
Status15 


Discrete 
Input14 


Discrete 
Input 
Status14 


Discrete 
Output 
Status14 


Discrete 
Input13 


Discrete 
Input 
Status15 


Discrete 
Output 
Status13 


Discrete 
Input12 


Discrete 
Input 
Status4 


Discrete 
Input 

Status12 
Discrete 


Output 
Status4 


Discrete 
Output 
Status12 


Discrete 


Input11 


Discrete 
Input 
Status11 


Discrete 
Output 
Status11 


Discrete 
Input10 


Discrete 
Input 
Status10 


Discrete 
Output 
Status10 


Bit 0 
Discrete 
Input1 


Discrete 
Input9 


Discrete 
Input 
Status] 


Discrete 
Input 
Status9 
Discrete 


Output 
Status1 


Discrete 
Output 
Status9 


The I/O Assembly data attribute for the input data with single input status bit and multiple 
output status bits has the format shown below. 


Table 6-12.13 I/O Assembly Data Attribute Format —Assy w/Mixed Input & Output Status Bits 


Instance 


70 


HA 


72 


73 


74 


75 


[aye[ wey [awe [mas [ea | ono | ae | oe 


Discrete 
Input 
Status 


Discrete Discrete Discrete | Discrete Discrete | Discrete | Discrete 
Input8 Input7 Input6 Input5 Input4 Input3 Input2 


Discrete 
Output 
Status3 


Reserved 


Discrete 


Output 
Status2 


Discrete 
Output 
Status2 


Discrete 
Output 
Status1 


Discrete 
Output 
Status1 


Discrete 
Output 
Status2 


Discrete 
Output 
Status1 


Discrete 
Output 
Status1 


Discrete 
Input3 


Discrete 
Input3 


Discrete 
Output 
Status3 


Discrete 
Output 
Status1 


Discrete 
Input2 


Discrete 
Input2 


Discrete 
Input2 


Discrete 
Input2 


Discrete 
Output 
Status2 


Reserved Discrete 
Output 
Status4 
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Bit 0 


Discrete 
Input1 


Discrete 
Input1 


Discrete 
Input1 


Discrete 
Input1 


Discrete 
Input1 


Discrete 
Input1 
Discrete 


Output 
Status1 
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Instance | Byte | Bit7 | 7 Bit | Bits | Bit | Bits | | Bit2 | 2 | Bita | 1 Bit 0 
76 Discrete eke Discrete eee Discrete | Discrete | Discrete Discrete 
Input8 Input7 Input6 Input5 Input4 Input3 Input2 Input1 
Discrete Discrete Discrete | Discrete Discrete | Discrete | Discrete Discrete 
Output Output Output Output Output =| Output Output Output 
Status8 Status7 Status6 Status5 Status4 Status3 Status2 Status] 
2 Discrete Reserved 
Input 
Status 
WH Discrete Discrete Discrete | Discrete Discrete | Discrete Discrete 
Input8 Input7 Input6 Input5 Input3 Input2 Input1 
1 Discrete Discrete Discrete | Discrete Discrete | Discrete Discrete 
Input16 Input15 Inputl4 | Input13 Input11 | Input10 Input9 
2 Discrete Discrete Discrete | Discrete Discrete | Discrete Discrete 
Output Output Output Output Output Output Output 
Status8 Status7 Status6 Status5 Status3 Status2 Status] 
33 Discrete Reserved 
Input 
Status 
78 Discrete Discrete Discrete | Discrete Discrete | Discrete Discrete 
Input8 Input7 Input6 Input5 Input3 Input2 Input1 
1 Discrete Discrete Discrete | Discrete Discrete | Discrete Discrete 
Input16 Input15 Inputl4 | Input13 Input11 | Input10 Input9 
2 Discrete Discrete Discrete | Discrete Discrete | Discrete | Discrete Discrete 
Output Output Output Output Output =| Output Output Output 
Status8 Status7 Status6 Status5 Status4 Status3 Status2 Status] 
3 Discrete Discrete Discrete | Discrete Discrete | Discrete | Discrete Discrete 
Output Output Output Output Output =| Output Output Output 
Status16 Status15 Status14 | Status13 Status12 | Status11 | Status10 Status9 
4 Discrete Reserved 


Input 


Status 


6-12.6 


Mapping I/O Assembly Data Attribute Components 


The following table indicates the I/O assembly Data attribute mapping for the General Purpose 
Discrete I/O device for the input assemblies with a single status bit. 


Table 6-12.14 I/O Assembly Data Mapping — Single Status Bit Assemblies 


Instance 


Attribute 


Data Component 


Name Number [Name [Number 
Discrete InputN Discrete Input Point a 3 


Status or Discrete Input Status 
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6-12.7.1 


6-12.8 


General Purpose Discrete I/O Device, Type: 07 pex 


Important: If I/O Assembly instances 7, 17, 27, 37, 47 or 57 are supported, the “Max 
Instance” attribute at the class level of the Discrete Input Point class or of the Discrete Output 
Point class must be supported. 


The following table indicates the I/O assembly Data attribute mapping for the General Purpose 
Discrete I/O device for the input assemblies with multiple status bits. 


Table 6-12.15 I/O Assembly Data Mapping — Multiple Status Bit Assemblies 


The following table indicates the I/O assembly Data attribute mapping for the General Purpose 
Discrete I/O device for the output assemblies. 


Data Component 


Name Number 


Discrete InputN 


StatusN or Discrete Input StatusN 


Table 6-12.16 I/O Assembly Data Mapping — Output Assemblies 


Data Component Instance Attribute 
Name Number Name Number 
Discrete Output StatusN Discrete Output Point 4 
Discrete Output Status Discrete Output Group 5 


Defining Device Configuration 


Primary public interface to the Input Filter Selection parameter is accessed by the Discrete 
Output Group Object. 


Input Configuration 


There are no configuration parameters defined for the discrete inputs. 


Output Configuration Assembly Instances 


The following table identifies the output configuration assembly instance supported by the 
General Purpose Discrete I/O device. 
Table 6-12.17 Output Configuration Assembly Instances 


Number Type Name 


40 Output Configuration 
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6-12.9 Output Configuration Assembly Data Attribute Format 


The Output Configuration Assembly Data attribute (typical throughout the document) has the 
format shown below. 


Table 6-12.18 Output — —— Data Attribute Format 


Instance | Bits | | pits | Bit2 | Bit1 | Bito 
40 Reserved eet Reserved pea Reserved | Reserved | Idle Fault 
Action Action 


6-12.10 Mapping Output Configuration Assembly Data Attribute Components 


The output configuration is accessed by instances of the Assembly Object Class. The following 
table indicates the output configuration assembly Data attribute mapping for the General 
Purpose Discrete I/O device. 


Table 6-12.19 Output Configuration Assembly Data Mapping 
Discrete Output Group Idle Action 


The following table shows the effect of the Fault State and Idle State parameters on behavior. 


Configuration 


Parameter Name 


Fault Action 


Idle Action 


Table 6-12.20 Effect of Fault State/Idle State on Behavior 


Parameter Effect on behavior 
Fault Action Indicates whether the Fault Value or the last state is to be placed 
at the output in the event of a fault. All Discrete Outputs in the 
device are set to the same Fault Action. Note: Fault Value 
cannot be configured via this assembly. The default is 0. 
Idle Action Indicates whether the Idle Value or the last state is to be placed 


at the output in the event of an idle. All Discrete Outputs in the 
device are set to the same Idle Action. Note: Idle Value cannot 
be configured via this assembly. The default is 0. 
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The following portion of an example EDS shows the information necessary to define the output 
configuration parameters for the General Purpose Discrete I/O device. 


[Params ] 


Parami=$ Fault Action 


0, $ reserved 
6,”20 1E 24 01 30 07”, $ Link Path Size and Link Path 
©x0000, $ No support for settable path, 
$ enumerated strings, scaling, 
$ scaling link, or real time 
$ update of value. Value is 
$ gettable and settable. 
OxC1, $ Data Type 
1, $ Data Size 
"Fault Action”, $ Parameter Name 
ae $ Units String not used 
ae $ Help string not used 
0,1,0; $ Min, Max, and Default values 
1,1,1,0,0,0,0,0,0; $ Not used 
Param2= $ Idle Action 
0, $ reserved 
6,”20 1E 24 01 30 09”, $ Link Path Size and Link Path 
0x00, $ No support for settable path, 
$ enumerated strings, scaling, 
$ scaling link, or real time 
$ update of value. Value is 
$ gettable and settable. 
4, $ Data Type 
1, $ Data Size 
"Tdle Action”, $ Parameter Name 
ats $ Units String not used 
jas $ Help string not used 
0,1,0; $ Min, Max, and Default values 
1,1,1,0,0,0,0,0,0; $ Not used 
[Groups ] $ No need to support 
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6-13 Communications Adapter Device 


Device Type: 0C Hex 


The Communications Adapter device type acts as a gateway from the CIP network to other 
technologies. Traditionally, a gateway connects to foreign networks (for example, RS-232) or 
backplanes (for example, VME). The technologies involved greatly affect the gateway 
modeling and definition. Initially, some devices will be defined as Communications Adapter 
devices, and the ODVA and CI forum may create a specific device profile for devices with 
similar functions. 


6-13.1 Object Model 


The Object Model in Figure 6-13.2 represents the minimum support in a Communications 
Adapter. The table below indicates: 


e the object classes present in this device 
e whether or not the class is required 
e the number of instances present in each class 


Table 6-13.1 Objects Present in a Communications Adapter 


Object Class # of Instances 
CIP Common Required Objects See Section 6-2.1 
Assembly Possibly 1 or more 
Application Possibly 1 or more 


The Communications Adapter profile cannot specify the definition of the Assembly Object or 
the type of application objects necessary for device operation. This portion of the device profile 
must be supplied by the product developer as described in Sections 6-1 through 6-7 inclusive. 
Any Assembly instances created must be in the vendor-specific range (64j,ex - C7hex): 


Application objects may be public, vendor-specific, or both. 
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Figure 6-13.2 Object Model for the Communications Adapter 


Application Objects 
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Message Router 


Assembly Object ) 


©) 


Connection Manager 
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Explicit 
Msg. 
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E> Optional Objects 
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6-14 General Purpose Analog I/O Device 


The profile for this device type will be defined by the Open DeviceNet Vendor Association, 
Inc. and ControlNet International. 
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6-15 AC/DC Drive Devices 


AC Drives Device Type: 02 Hex 
DC Drives Device Type: 13 Hex 


These device profiles describe standard objects and behavior for AC and DC drives including 
Standard Scalar (V/Hz) AC, Vector AC, and DC Drives. 


The functionality of drives covered includes: 


e Open loop speed (frequency) control 
e Closed loop speed (frequency) control 
e Torque control 

e No position control 


These profiles make the drives inter-operable, but not directly interchangeable without doing 
drive configuration through the drive local interface, a network configuration tool or other 
means of configuration outside the CIP interface. 


The AC and DC Drive profiles are part of a “Hierarchy of Motor Control Devices” that is 
supported by CIP. This hierarchy includes: 


e Contactors and Across the Line Motor Starters 
e Soft Starters 
e AC and DC Drives 


e Servo Drives 


Devices within this hierarchy all use a common “Control Supervisor” object to control the state 
behavior of the device. All but the low level Contactors and Across the Line Motor Starters 
also use a common “Motor Data” object to store information about the motor to be controlled. 
The Hierarchy of Motor Control Devices also supports a hierarchy of IO Assembly Instance 
definitions. Assembly instances are numbered within the hierarchy so that each device type is 
assigned a range of Assembly Instance numbers, with higher functionality devices supporting 
higher instance numbers. Devices in the hierarchy can choose to support some IO Assembly 
Instance numbers that are lower than theirs in the hierarchy. For example an AC Drive may 
choose to support some IO Assemblies that are defined in the Starter Profile to make it easier to 
interchange drives and starters in a system. 


6-15.1 Multiple axes on one drive 


It is possible to implement several axes of control on one physical drive unit. A separate MAC 
ID must be assigned to each axis so each axis is treated as separate CIP node. 
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6-15.2 Object Model 
The Object Model in figure 6-15.2 represents an AC or DC Drive. The table below indicates 


e the object classes present in this device 
e whether or not the class is required 
e the number of instances present in each class 


Chapter 5, The CIP Object Library, provides more details about these objects. 


Table 6-15.1 Objects Present in an AC/DC Drive 


Discrete Output Optional - 
Analog Input Optional - 


Object Class # of Instances 
Message Router 1 
CIP Common Required Objects See Section 6-2.1 
Control Supervisor 1 
AC/DC Drive 1 
Motor Data dl 
Parameter Group - 
Discrete Input - 

| Optional 

| Optional | 

| Optional 


Analog Output Optional - 
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Figure 6-15.2 Object Model for AC and DC Drives 
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6-15.3. How Objects Affect Behavior 
The objects in this device affect the device's behavior as shown in the following table. 


Table 6-15.3 Object Effect on Behavior 


Object Effect on Behavior 
CIP Common Required | See Section 6-2.2 for details. 
Assembly Defines I/O data format 
Control Supervisor Manages drive functions, operational states and control 
AC/DC Drive Provides drive configuration 
Motor Data Defines motor data for the motor connected to this device 
Parameter Provides a public interface to device configuration data 
Parameter Group Provides an aid to device configuration 
Discrete Input Defines the behavior of discrete inputs on this device 
Discrete Output Defines the behavior of discrete outputs on this device 
Analog Input Defines the behavior of analog inputs on this device 
Analog Output Defines the behavior of analog outputs on this device 


6-15.4 Defining Object Interfaces 
The objects in this device have the interfaces listed in the following table. 


Table 6-15.4 Object Interfaces 


Object Interface 
CIP Common Required | See Section 6-2.3 for details. 
Assembly I/O Connection or Message Router 
Control Supervisor Message Router, Assembly or Parameter Object 
AC/DC Drive Message Router, Assembly or Parameter Object 
Motor Data Message Router or Parameter Object 
Parameter Message Router 
Discrete Input Message Router or Assembly 
Discrete Output Message Router or Assembly 
Analog Input Message Router or Assembly 
Analog Output Message Router or Assembly 
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6-15.5 I/O Assembly Instances 


The IO Assembly Instance definitions in this section define the format of the “data” attribute 
(attribute 3) for IO Assembly Instances. Through the use of predefined instance definitions, IO 
Assemblies support a hierarchy of motor control devices. The device hierarchy includes motor 
starters, soft starters, AC and DC drives, and servo drives. Assembly Instances are numbered 
within the hierarchy so that each device type is assigned a range of Assembly Instance 
numbers, with higher functionality devices supporting higher instance numbers. Devices in the 
hierarchy can choose to support instance numbers that are lower than theirs in the 
hierarchy. For example an AC drive may choose to support some IO Assemblies that are 
defined in the starter profile to make it easier to interchange starters and drives within a system. 
The following table shows the Assembly Instance numbering for the motor control device 
hierarchy. 


Table 6-15.5 I/O Assembly Instance Numbering Ranges 


Profile Instance Instances within 
Range hierarchy that may be 
implemented for this 
product type. 
AC Motor Starter 1-19 
Soft Start Starter 50-69 
AC or DC Drive 1-29 
50-79 
Servo Drive 1-49 
50-99 


The following IO Assembly Instances are defined for AC and DC Drives. 


Table 6-15.6 I/O Assembly Instances 


Number 
decimal a Resulbed Opuanel Name 


23 Extended Speed and Torque Control Output 


If a bit is not used in an IO Assembly, it is reserved for use in other Assemblies. Reserved bits 
in Output Assemblies are ignored by the consuming device. Reserved bits in Input Assemblies 
are set to zero by the producing device. 
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6-15.6 


AC/DC Drive Devices, Types: 024. and 13 yx 
Reserved bits in the IO Assembly Data Attribute Format Tables are shaded. 


Connection Paths to I/O Assembly Instances 


The IO Assembly Instances are chosen for IO Connections by setting the 
“produced_connection_path” (attribute 14) and “consumed_connection_path” (attribute 16) 
attributes in the appropriate connection object. 


AC and DC Drives use the Symbolic Segment Type (see Appendix C) to specify paths to the 
IO Assembly Instances in the Motor Control Hierarchy. IO Assembly Instances are represented 
by ASCI strings that contain the hex number of the Assembly Instance whose path is to be 
chosen. 


The following example shows the Symbolic Segment used to specify Output Assembly 
Instance 20 (14 hex). 


Figure 6-15.7 Symbolic Segment Example for Output Assy 


Segment Type First Character Second Character 
0 11/0 00 1 0 0011000 1 0011010 0 
Segment Symbol size in ASCII 1 (31 hex) ASCII 4 (34 hex) 
type bytes (2 bytes) 
(symbolic) 


I/O Assembly Data Attribute Format 
The I/O Assembly Data Attributes have the format shown below. 


Table 6-15.8 I/O Assembly Data Attribute Format 


Instance 


20 wa | Fault Run 
Reset Fwd 
| 
Speed Reference (Low Byte) 
Speed Reference (High Byte) 
21 iz NetRef — |NetCtrl | Fault Run Run 
Reset Fwd 
| 
Speed Reference (Low Byte) 
Speed Reference (High Byte) 
=e ae | 
Reset 
| | 
Speed Reference (Low Byte) 
Speed Reference (High Byte) 
Torque Reference (Low Byte) 
5 Torque Reference (High Byte) 
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Bit 1 Bit 0 


Run Rev | Run Fwd 


Instance Bit 6 Bit 5 
23 a NetRef | NetCtrl 


BR 


Speed Reference (Low Byte) 
Speed Reference (High Byte) 
Torque Reference (Low Byte) 
Torque Reference (High Byte) 
‘ (Re 
Reset 
| | 
Speed Reference (Low Byte) 
Speed Reference (High Byte) 
4 Process Reference (Low Byte) 
Process Reference (High Byte) 
= ee an a 
Reset 
Mode 
Speed Reference (Low Byte) 
Speed Reference (High Byte) 
Process Reference (Low Byte) 
Process Reference (High Byte) 
7m [o | inst IT Fates 
| | 
Speed Actual (Low Byte) 
Speed Actual (High Byte) 
Reference | Net Net (Rev) (Fwd) 
Drive State 
Speed Actual (Low Byte) 
Speed Actual (High Byte) 
72 El | | Faulted 
1 
Speed Actual — Byte) | 
Speed Actual (High Byte) 
Torque Actual (Low Byte) 
Torque Actual (High Byte) 
73 ey At Running2 Warning | Faulted 
Reference | Net Net (Rev) (Fwd) 
Drive State 
Speed Actual (Low Byte) 
Speed Actual (High Byte) 
Torque Actual (Low Byte) 
Torque Actual (High Byte) 
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1 


Speed Actual (Low Byte) 

Speed Actual (High Byte) 

Process Actual (Low Byte) 
Process Actual (High Byte) 


Ref From |Ctrl From | Ready Running2 |Running1 |Warning | Faulted 
Reference | Net Net (Rev) (Fwd) 


Drive State 
Speed Actual (Low Byte) 
Speed Actual (High Byte) 
Process Actual (Low Byte) 
Process Actual (High Byte) 


N 
uo 
ag 


Mapping I/O Assembly Data Attribute Components 


The following table indicates the I/O Assembly Data Attribute mapping for AC and DC Drive 
Output Assemblies. 


Table 6-15.9 I/O Assembly Data Mapping — Output Assemblies 


Data Component Instance Attribute 
Name Number Number 


RunFwd Control 29hex 1 Run1 3 
Supervisor 

RunRev Control 29nex 1 Run2 
Supervisor 

Fault Reset Control 29nex 1 FaultRst 12 
Supervisor 

NetCtrl Control 29nex 1 NetCtrl 
Supervisor 

NetRef AC/DC 2Anex 1 NetRef 4 

Drive 


os 


uo 


Net Proc AC/DC 2Anex 1 NetProc 5 
[etl ay ol ce 

Drive Mode AC/DC 2Anex 1 DriveMode 6 
ee a a a 

Speed Reference AC/DC 2Anex 1 SpeedRef 8 
ed el ee 

12 


Torque Reference AC/DC 2Anex 1 TorqueRef 
Drive 

Process Reference AC/DC 2Anex 1 ProcessRef 14 
Drive 
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The following table indicates the I/O Assembly Data Attribute mapping for AC and DC Drive 
Input Assemblies. 


Table 6-15.10 I/O Assembly Data Mapping — Input Assemblies 


Data Component Instance Attribute 
Name Number | Number Number 


Faulted Control 29h ae 1 Faulted 10 
Supervisor 

Warning Control 2932 1 
Supervisor 

Running1 (Fwd) Control 29nex 1 Running1 
Supervisor 

Running2 (Rev) Control 29 ise 1 Running2 
Supervisor 

Ready Control 29nex 1 Ready 
Supervisor 

CtrlFromNet Control 29nex 1 CtrlFromNet 15 
Supervisor 


E 
= 
2 
= 
i=} 
ga 
a 


© N 


wo 


n 


Drive State Control 29nex 1 State 
Supervisor 

Ref From Net AC/DC 2Anex 1 RefFromNet 29 
Drive 

At Reference AC/DC 2Anex 1 AtReference 
Drive 

Speed Actual AC/DC 2Anex 1 SpeedActual 
Drive 

Torque Actual AC/DC 2Anex 1 TorqueActual 
Drive 

Process Actual AC/DC 2Anex 1 ProcessActual 
Drive 


Defining Device Configuration 


w 


N 


BR 


1 


BR 


3 


Public access to the Control Supervisor Object, the Motor Data Object, and the AC/DC Drive 
Object must be supported for configuration of an AC or DC drive. If supported, the optional 
Parameter Objects may be used to access the various configuration attributes in the Control 
Supervisor Object, the Motor Data Object, and the AC/DC Drive Object. 


AC and DC drives may contain (but are not limited to) any of the Parameter Object instances 
listed in the table below. Suggested parameter names are also given in the table. The set of 
parameters instances that are supported by a drive should be numbered sequentially with lower 
instance numbers assigned to parameters that appear earlier in the table. Vendor specific 
parameter instances should be numbered sequentially following the instances that appear in the 
following table. 


Parameter Object instances may be implemented as EDS file definitions, parameter stubs, or 
full parameter objects. See Chapter 5 of the CIP Common specification for a definition of the 
Parameter Object and an explanation of how it is used for configuration. 
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6-15.8.1 


Mapping Parameter Object Data 


The following table indicates the Parameter Object data mapping for an AC or DC Drive 


device. 


Table 6-15.11 Parameter Object Data Mapping 


Configuration 
Parameter 


Name 

Motor Type 

Motor Cat Number 
Motor Vendor 
Motor Rated Cur 
Motor Rated Volt 
Motor Rated Pwr 
Motor Rated Freq 
Motor Rated Temp 
Motor Max Speed 
Motor Pole Count 
Motor Torq Const 
Motor Inertia 
Motor Base Speed 
Motor Field Cur 
Min Field Cur 
Rated Field Volt 
Service Factor 
Network Control 


Drive State 
Running Fwd 
Running Rev 
Ready 

Faulted 

Warning 

Fault Reset 
Fault Code 
Warning Code 
Control From Net 
DN Fault Mode 
Force Fault 
Force Status 

At Reference 
Network Ref 
Network Process 
Drive Mode 
Speed Actual 
Speed Reference 
Current Actual 
Current Limit 
Torque Actual 
Torque Reference 
Process Actual 


Class 


Name 

Motor Data 
Motor Data 
Motor Data 
Motor Data 
Motor Data 
Motor Data 
Motor Data 
Motor Data 
Motor Data 
Motor Data 
Motor Data 
Motor Data 
Motor Data 
Motor Data 
Motor Data 
Motor Data 
Motor Data 


Control Supervisor 
Control Supervisor 
Control Supervisor 
Control Supervisor 
Control Supervisor 
Control Supervisor 
Control Supervisor 
Control Supervisor 
Control Supervisor 
Control Supervisor 
Control Supervisor 
Control Supervisor 
Control Supervisor 
Control Supervisor 
AC/DC Drive 
AC/DC Drive 
AC/DC Drive 
AC/DC Drive 
AC/DC Drive 
AC/DC Drive 
AC/DC Drive 
AC/DC Drive 
AC/DC Drive 
AC/DC Drive 
AC/DC Drive 


2 
2 
2 
2 
2 


ico) 


i<o) 


[ 29, | 
[| 29nex | 
[29 | 
[| 29n. _| 


CO} CO] 


ico) 


8 nex 
8 nex 
8 nex 
8 nex 
8 nex 
8 nex 
8 nex 
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Instance 


Attribute 


Name 
MotorType 
CatNumber 
Manufacturer 
RatedCurrent 
RatedVoltage 
RatedPower 
RatedFreq 
RatedTemp 
MaxSpeed 
PoleCount 
TorqConstant 
Inertia 
BaseSpeed 
RatedFieldCur 
MinFieldCur 
RatedFieldVolt 
ServiceFactor 
NetCtrl 

State 
Running1 
Running2 
Ready 
Faulted 
Warning 
FaultRst 
FaultCode 
WarningCode 
CtrlFromNet 
DNFaultMode 
ForceFault/Trip 
ForceStatus 
AtReference 
NetRef 
NetProc 
DriveMode 
SpeedActual 
SpeedRef 
CurrentActual 
CurrentLimit 
TorqueActual 


TorqueRef 
ProcessActual 


Number 
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Configuration Class Attribute 


Parameter 


Instance 


Name Number 
Process Reference 14 
Power Actual 15 
Input Voltage 16 
Output Voltage 17 
Accel Time 18 
Decel Time 19 
Low Speed Limit 20 
High Speed Limit 24 
Speed Scale 22 
Current Scale 23 
Torque Scale 24 
Process Scale 25 
Power Scale 26 
Voltage Scale 27 
Time Scale 28 
Ref From Net 29 
Proc From Net 30 
Field I or V 31 
Field Voltage Ratio 32 
Field Cur Set Pt 33 
Field Weak Ena 34 
Field Cur Actual 35 
Field Min Cur 36 


6-15.8.2. Parameter Group Objects 


AC and DC drives may contain (but are not limited to) any of the Parameter Group Object 
Instances listed in the table below. If Parameter Groups are supported, Parameter Instances 
should be grouped according to the object that their data is mapped to. For example, all 
Parameters Instances whose data maps to the Motor Data Object should be contained in the 
Motor Group (Parameter Group Object Instance 1). 


Parameter Group Object instances may be implemented from an EDS file, or as actual 
Parameter Group objects from the device. See Chapter 5 of the CIP Common specification for a 
definition of the Parameter Group Object. 
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Table 6-15.12 Parameter Group Object Instances 


Parameter Group Instance Parameters in Group 
Name Number 


Motor 1 Motor Type 
Motor Cat Number 
Motor Vendor 
Motor Rated Cur 
Motor Rated Volt 
Motor Rated Pwr 
Motor Rated Freq 
Motor Rated Temp 
Motor Max Speed 
Motor Pole Count 
Motor Torq Const 
Motor Inertia 
Motor Base Speed 
Motor Field Cur 
Min Field Cur 

Rated Field Volt 

Rated Field Volt 

Service Factor 
Supervisor 2 Network Control 

Drive State 

Running Fwd 

Running Rev 

Ready 

Faulted 

Warning 

Fault Reset 

Fault Code 

Warning Code 

Control From Net 

DN Fault Mode 

Force Fault 

Force Status 


— 6-67 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 6: Device Profiles, Part 1 
AC/DC Drive Devices, Types: 024. and 13 yex 


Parameter Group Instance Parameters in Group 
Name Number 
Drive 3 At Reference 
Network Ref 
Network Process 
Drive Mode 
Speed Actual 


Speed Reference 
Current Actual 
Current Limit 
Torque Actual 
Torque Reference 
Process Actual 
Process Reference 
Power Actual 
Input Voltage 
Output Voltage 
Accel Time 
Decel Time 

Low Speed Limit 
High Speed Limit 
Speed Scale 
Current Scale 
Torque Scale 
Process Scale 
Power Scale 
Voltage Scale 
Time Scale 

Ref From Net 
Proc From Net 
Field I or V 

Field Voltage Ratio 
Field Cur Set Pt 
Field Weak Ena 
Field Cur Actual 
Field Min Cur 
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Servo Drive Device, Type: Not Assigned 


6-16 Servo Drive Device 


This device profile for a Servo Drive is presently under development. It is intended that this 
profile will be defined by the Servo Drive SIG of the Open DeviceNet Vendor Association, 
Inc. and ControlNet International. 
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6-17 Barcode Scanner Device 


The profile for this device type will be defined by the Open DeviceNet Vendor Association, 
Inc. and ControlNet International. 
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6-18 Position Controller Device 


Device Type: 10hex 


A Position Controller controls the motion and position of a motor or linear actuator (servo, 
stepper, etc.). The position controller may or may not include an integrated drive. Positioning is 
achieved with a controlled motion profile. The motion profile is defined by Acceleration, 
Velocity, Deceleration, Position or Torque. 


6-18.1 Object Model 
The Object Model in figure 6-18.2 represents a Position Controller Device. The table below 
indicates: 


e the object classes present in this device 

e whether or not the class is required 

e the number of instances present in each class 

Chapter 5, Object Library, provides more details about these objects. 


Table 6-18.1 Objects Present in a Position Controller Device 


Drive Optional 1 per Axis 
Motor Data Optional 1 per Axis 


Object Class # of Instances 

CIP Common Required Objects See Section 6-2.1 

Position Controller Supervisor 1 per Axis 

Position Controller 1 per Axis 

Command Block - 

Block Sequencer 1 per Axis 
Optional 
Optional 
[Optional 


Parameter Optional 


6-18.1.1 | Model Description 


The object model shown below describes how the Position Controller device is controlled 
through CIP. Attributes can be set and queried in the normal manner for configuration. The 
Position Controller object handles the interface to the internal or external drive unit. The motor 
and drive units can be servo, stepper or some other method with optional feedback (open or 
closed loop). 


In addition, the Command Block objects and the Block Sequencer object can be used to 
perform complex moves, modify attributes or wait for attributes to become valid. Command 
Blocks can be linked together to form a command chain with branching and looping supported. 
The user can download command block sequences during configuration and execute them at 
any time to perform complex moves or modify attributes. The Block Sequencer object is 
accessible through the I/O command message giving the user the ability to perform complex 
motion sequences from a PLC or scanner card. 
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Figure 6-18.2 Object Model for a Position Controller 
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6-18.2 How Objects Affect Behavior 


The objects for this device affect the device’s behavior as shown in the table below. 


Table 6-18.3 Object Effect on Behavior 


CSD Optional C2 


Object Effect on behavior 
CIP Common Required See Section 6-2.2 for details. 


Position Controller Supervisor | Handles faults, home and registration inputs and modifies meaning of I/O data 


Position Controller Provides positioning control and manages interface to power amplifier 
Block Sequencer Executes command block sequences 
Command Block Defines the behavior of command blocks 
Drive Manages power amplifier 
Motor Data Configures the power amplifier for motor parameters 
Parameter Defines the behavior of Parameters 
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6-18.3 Defining Object Interfaces 
The objects in this device have the interfaces listed in the following table: 


Table 6-18.4 Object Interfaces 


Object Interface 


CIP Common Required See Section 6-2.3 for details. 

Position Controller Supervisor | Message Router or Position Controller Supervisor Class 
Position Controller Message Router or Position Controller Supervisor Class 
Block Sequencer Message Router or Position Controller Supervisor Class 
Command Block Message Router or Position Controller Supervisor Class 
Drive Message Router or Position Controller Supervisor Class 
Motor Data Message Router or Position Controller Supervisor Class 
Parameter Message Router 


6-18.4 I/O Connection Messages 


The Position Controller Profile supports both command and response messages via the I/O 
connection. The produced and consumed paths specify the Position Controller Supervisor Class 
attributes as shown in Figure 6-18.2. 


6-18.4.1 Message Formats 


The Position Controller Profile supports multiple axes per CIP node by allowing up to seven 
instances of each of the axis objects, in one Position Controller device. The axis objects are the 
1) position controller supervisor, 2) position controller: 3) drive: 4) motor data: and 5) block 
sequencer. The I/O message can contain data from more than one axis object. The Command 
Axis Number and the Response Axis Number shown in the Message Format specifies the 
instance number of the axis object whose data is contained in the I/O message. 


Table 6-18.5 Command Message Format 
Byte | Bit7 |  Bit6 | Bits | Bird | Bits | Bit2 | Biri | Biro 


0 Enable Reg Arm Hard Smooth | Direction | Incremental | Start Load Data/ 
Stop Stop (V. Mode) Block | Start Profile 


1 Command Data 1 


Command Axis Number Command Message Type 


Command Data 2 
Command Data 3 
Command Data 4 
Command Data 5 
Command Data 6 


NYO] Oa) R]W]NM 
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Table 6-18.6 Response Message Format 


0 Enable Reg Level Home Current General | On Target | Block in | Profile in 
Level Direction Fault Position | execution | Progress 
1 


Response Data 1 


Complete Limit Limit Limit Limit Fault 
3 Response Message Type 
4 Response Data 2 
Bi} Response Data 3 
6 Response Data 4 
7 Response Data 5 


Note that a response message may contain data for a different axis number from what was 
contained in the command message. If an error is detected in the command or its requested 
response message, the response message shall be Command/Response Error Message Type 14 
hex, not the requested response message. 


6-18.4.2 Definition of a Profile Move 


A profile move is a move that uses Acceleration, Target Velocity, and Deceleration to run at a 
Target Velocity or to a Target Position. In addition, the position controller device can output a 
Torque command. Whether or not the position controller device runs at a Target Velocity, to a 
Target Position or outputs a Torque command depends on the Operating Mode (Position 
Controller Object Attribute 3), to which the position controller device is set. The position 
controller device is set to Position, Velocity or Torque Mode using Position Controller Object 
Attribute 3. 


6-18.4.3 Starting a Profile Move 


The Position Controller Profile is mode-sensitive. The Position Controller Object Attribute 3 
sets the mode of the controller to the following: 


0 = Position (default) 
1 = Velocity 
2 = Torque 
A profile move starts when the command message type for the specified mode is loaded and 


the Load Data/Start Profile bit transitions from zero to one. The table below shows the 
command message type, which starts a profile move for each mode. 


Table 6-18.7 Command Message Type 


Mode (Attribute 3) Command Message Type which Starts Motion 
0 = Position 01 = Position 

1 = Velocity 02 = Velocity 

2 = Torque 05 = Torque 
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6-18.4.4 I/O Handshaking Procedure 


Proper handshaking between the client and the server is essential in I/O messaging to ensure 
that data sent to the position controller device is properly received. Two bits are used to 
provide handshaking between command and response messages. The recommended 
handshaking procedure for the client is described in the flowcharts in figure 6-18.8 and figure 
6-18.9 below. The behavior required from the server to implement the handshake procedure is 
described in figure 6-18.10 and figure 6-18.11. Refer to the timing diagram in figure 6-18-12 
below for representative timing of these bits during the handshake sequence 


Figure 6-18.8 Client Data Loading Procedure 


Load Command Data Values, 

Command Axis Number, and 

Command Type into Command 
Message 
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Table 6-18.9 Client Profile Move Procedure 


Call Client Data Loading 
Procedure 


Is Profile in 
Progress bit in 
response 
message = 0? 
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Table 6-18.10 Server Behavior 


Is 
Load Data/Start 
Profile bit in 
Command 
Message 
=1? 


Yes 


Load data values in command message 


into Position Controller Device 


message type that 
starts a Profile Move 
loaded in the 
command 
message field? 


Yes 
Set Profile in Progess bit=1 
Start Profile Move 
Start Profile Monitoring Procedure 


Set Load Data Complete = 1 


Is Load 
Data/Start 
Profile bit 
=0? 


Yes 
Set Load Data Complete = 0 
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Table 6-18.11 Profile Monitoring Procedure 


Is Profile 
complete/ 
terminated? 


Set Profile in Process bit=0 


Table 6-18.12 Timing Diagram 
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* Data Successfully Loaded into Position Control Object 
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Position Controller Device, Type: 101Hex 


I/O Connection Message Types 


Command Message Types 


The command message type is defined by byte 02 of the message. Byte 00 is the same for all 
command message types. Bytes 01 and 03 through 07 are defined by the Command Message 
Type code in byte 02. In message types 01 through 05, byte 03 defines the requested Response 
axis number and Response Message Type format. For message types 19 hex through 1F hex, 
the requested Response axis number and Response Message Type is the same as the Command 
axis number and Command Message Type. 


Table 6-18.13 Command Message Type_01 hex Target Position - Optional 
Byte |Bit7 _—*(|Bit6__—s| Bits | Bitd | Bit3 | Bit2 [Bit [Biro 


0 Enable Reg Arm Hard Smooth | Direction | Incremental | Start Load Data/ 
Stop Stop (V. Mode) Block | Start Profile 


1 Block # 

2 Command Message Type 
3 Response Message Type 
4 Target Position Low Byte 

5 Target Position Low Middle Byte 

6 Target Position High Middle Byte 

7 Target Position High Byte 


Table 6-18.14 Command Message Type 02 hex Target Velocity - Optional 
Byte |Bit7 _—*|Bité__—s[ Bits [Bia | Bit3 | Bit2 [Bit [Biro 
0 Enable Reg Arm Hard Smooth | Direction | Incremental | Start Load Data/ 
Stop Stop (V. Mode) Block | Start Profile 
Block # 


Command Axis Number Command Message Type 
Response Axis Number Response Message Type 


Target Velocity Low Byte 
Target Velocity Low Middle Byte 
Target Velocity High Middle Byte 
7 Target Velocity High Byte 


DUpRPwWlmole 


Table 6-18.15 Command Message Type 03 hex Acceleration - Optional 
Byte |Bit7 _—*|Bit6 | Bit5 | Bita | Bit3—— | Bit2_—| Bit 1 [ Bit 


0 Enable Reg Arm Hard Smooth Direction | Incremental | Start | Load Data/ 
Stop Stop (V. Mode) Block | Start Profile 


1 Block # 
2 Command Axis Number Command Message Type 
3 Response Axis Number Response Message Type 
4 Acceleration Low Byte 
5 Acceleration Low Middle Byte 
6 Acceleration High Middle Byte 
7 Acceleration High Byte 
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Table 6-18.16 Command Message Type 04 hex Deceleration - Optional 


Byte |Bit7 _—([Bit6 _—|[ Bits |Bit4 _—[Bit3 _—[Bit2 | Bit1_| Bito 


Oo 


DUNpRPWIm]e 


7 


Enable Reg Arm Hard Smooth Direction | Incremental | Start | Load Data/ 
Stop Stop (V. Mode) Block | Start Profile 


Block # 
Command Axis Number Command Message Type 
Response Axis Number Response Message Type 


Deceleration Low Byte 
Deceleration Low Middle Byte 
Deceleration High Middle Byte 

Deceleration High Byte 


Table 6-18.17 Command Message Type 05 hex Torque - Optional 


Byte |Bit7 _—([Bit6 _—s|[ Bits | Bit4 _—[Bit3 _—|Bit2_ | Bit1 | Bito 


Oo 


DUNpR]Wlmo]e 


7 


Enable Reg Arm Hard Smooth Direction | Incremental | Start | Load Data/ 
Stop Stop (V. Mode) Block | Start Profile 


Block # 
Command Message Type 
Response Message Type 
Torque Low Byte 
Torque Low Middle Byte 
Torque High Middle Byte 
Torque High Byte 


Table 6-18.18 Command Message Type 19 hex Motor Data Attribute - Optional 


Byte |Bit7 _|Bité _—s [Bits _—|Bitd _—[Bit3 _— | Bit2_ | Bit1 | Bito 


0 


NPD] R WM] R 


Enable Reg Arm Hard Smooth Direction | Incremental | Start | Load Data/ 
Motor Data Attribute to Get 
Command Message Type 
Motor Data Attribute to Set 
Motor Data Attribute Value Low Byte 
Motor Data Attribute Value Low Middle Byte 
Motor Data Attribute Value High Middle Byte 
Motor Data Attribute Value High Byte 


Table 6-18.19 Command Message Type 1A hex Position Controller Supervisor Attribute - 
Optional 


Byte |Bit7 _—|Bité _—s[Bit5 _—*|Bita _—s[Bit3 — | Bit2_ | Bit 1 | Bit 


Oo 


NTO] UPR ]W)]NMyR 


Enable Reg Arm Hard Smooth Direction | Incremental | Start | Load Data/ 
Stop Stop (V. Mode) Block | Start Profile 


Position Controller Supervisor Attribute to Get 


Command Axis Number Command Message Type 


Position Controller Supervisor Attribute to Set 
Position Controller Supervisor Attribute Value Low Byte 
Position Controller Supervisor Attribute Value Low Middle Byte 
Position Controller Supervisor Attribute Value High Middle Byte 
Position Controller Supervisor Attribute Value High Byte 
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Table 6-18.20 Command Message Type 1B hex Position Controller Attribute - Optional 


Byte |Bit7 _|Bité _—s [Bits _—|Bit4 _—[Bit3 _— | Bit2_ | Bit1 | Bito 


Oo 


DUNpR[WIN]e 


7 


Enable Reg Arm Hard Smooth Direction | Incremental | Start | Load Data/ 
Position Controller Attribute to Get 
Command Message Type 
Position Controller Attribute to Set 
Position Controller Attribute Value Low Byte 
Position Controller Attribute Value Low Middle Byte 
Position Controller Attribute Value High Middle Byte 
Position Controller Attribute Value High Byte 


Table 6-18.21 Command Message Type 1C hex Block Sequencer Attribute - Optional 


Byte |Bit7 _|Bité _—s [Bits _—|Bit4 _—[Bit3 _— | Bit2 | Bit 1 | Bito 


Oo 


DUpRPWINm]e 


7 


Enable Reg Arm Hard Smooth Direction | Incremental | Start | Load Data/ 
Block Sequencer Attribute to Get 
Command Message Type 
Block Sequencer Attribute to Set 
Block Sequencer Attribute Value Low Byte 
Block Sequencer Attribute Value Low Middle Byte 
Block Sequencer Attribute Value High Middle Byte 
Block Sequencer Attribute Value High Byte 


Table 6-18.22 Command Message Type 1D hex Drive Data Attribute - Optional 


Byte |Bit7 _|Bité _—s [Bits _—|Bit4 _—[Bit3 — | Bit2 | Bit1 | Bito 


Oo 


DU RPwWlm]e 


7 


Enable Reg Arm Hard Smooth Direction | Incremental | Start | Load Data/ 
Drive Data Attribute to Get 
Command Message Type 
Drive Data Attribute to Set 
Drive Data Attribute Value Low Byte 
Drive Data Attribute Value Low Middle Byte 
Drive Data Attribute Value High Middle Byte 
Drive Data Attribute Value High Byte 


Table 6-18.23 Command Message Type 1E hex Command Block Attribute - Optional 


Byte |Bit7 _—|Bité _—s[Bit5 _—*|Bit4 _—[Bit3 — | Bit2_ | Bit 1 | Bit 


Oo 


NTO] URW) NMyR 


Enable Reg Arm Hard Smooth Direction | Incremental | Start | Load Data/ 
Command Block Attribute to Get/Set 
Command Message Type 
Command Block Instance to Get/Set 
Command Block Attribute Value Low Byte 
Command Block Attribute Value Low Middle Byte 
Command Block Attribute Value High Middle Byte 
Command Block Attribute Value High Byte 
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Table 6-18.24 Command Message Type 1F hex Parameter - Optional 
Byte |Bit7 _—([Bité || BitS | Bitd | Bit3 | Bit2_——| Bit [ Bit 
0 Enable Reg Arm Hard Smooth Direction | Incremental | Start | Load Data/ 
Parameter Instance to Get 
Command Message Type 
Parameter Instance to Set 
Parameter Value Low Byte 
Parameter Value Low Middle Byte 
Parameter Value High Middle Byte 
Parameter Value High Byte 


NO] UP R]W)] Myre 


6-18.5.2. Semantics 


6-18.5.2.1 Load Data/ Start Profile 
Set from zero to one to load command data. The transition of this bit from zero to one will also 
start a Profile Move when the command message type contained in the command message field 
is the message type that starts a Profile Move for the mode selected. Refer to Section 6-18.4.3 
for an explanation of what commands start a Profile Move for a given mode. 

6-18.5.2.2 Start Block 
This bit is used to execute a Command block or Command block chain. Set from zero to one to 
execute a command block or command block chain. 

6-18.5.2.3 Incremental 
This bit is used to define the position value as either absolute or incremental. 0 = absolute 
position value and 1 = incremental position value. 

6-18.5.2.4 Direction (V. Mode) 
This bit is used to control the direction of the motor in Velocity mode. A 1 = forward, positive 
and a 0 = reverse, negative. 

6-18.5.2.5 Smooth Stop 
This bit is used to bring the motor to a controlled stop at the currently implemented 
deceleration rate. 

6-18.5.2.6 Hard Stop 
This bit is used to bring the motor to an immediate stop. 


6-18.5.2.7 Reg Arm 


This bit is used to arm the registration input. When the registration input is triggered, the 
registration action will be executed. 


6-18.5.2.8 Enable 


This bit is used to control the enable output. Clearing this bit will set the enable output inactive 
and the currently executing motion profile will be aborted. 


6-18.5.2.9 Block # 


This byte defines the block number to be executed when the Start Block bit transitions from 
zero to one. 


6-18.5.2.10 | Command Message Type 
This field defines the Command Message Type 
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6-18.5.2.11 Response Message Type 
This field defines the Response Message Type 


6-18.5.2.12 Command Axis Number 


These three bits define the Consumed Axis Connection attribute of the Position Controller 
Supervisor class. This attribute value specifies the instance number of all of the axis objects 
whose data are contained in the I/O command message. The command axis number is 
specified as shown in the table below: 


Table 6-18.25 Command Axis Numbers 


Byte 2 
Command Axis Number | Bit? | BitS Bit 5 
1 ee 0 
1 a ee ee ee 1 
2 e== 05 Se] me et 0 
3 = S08 wis el = 1 
4 Fe ee ee ee 0 
5 ae eee oem eel 1 
6 0 
7 1 


Note that axis 1 can be specified by either 0 or 1. Axis zero is not allowed. 


6-18.5.2.13 Target Position - Command Message Type 01 hex 
This double word defines the Profile Move’s Target Position in position units, when the Load 
Data /Start Profile bit transitions from zero to one. 

6-18.5.2.14 Target Velocity - Command Message Type 02 hex 
This double word defines the Profile Move’s Target Velocity in profile units, when the Load 
Data /Start Profile bit transitions from zero to one 

6-18.5.2.15 Acceleration - Command Message Type 03 hex 
This double word defines the Profile Move’s Acceleration in profile units, when the Load Data 
/Start Profile bit transitions from zero to one.. 

6-18.5.2.16 | Deceleration - Command Message Type 04 hex 
This double word defines the Profile Move’s Target Position in profile units, when the Load 
Data /Start Profile bit transitions from zero to one 

6-18.5.2.17 Torque - Command Message Type 05 hex 
This double word is used to set the output torque, when the Load Data /Start Profile bit 
transitions from zero to one. The torque value will only take effect when in torque mode. 
(Position Controller Object Attribute 3 = 2) 

6-18.5.2.18 Attribute Value —- Command Message Types 19 — 1E hex 
This double word defines the value of the attribute to set, when the Load Data/Start Profile bit 
transitions from zero to one. 

6-18.5.2.19 Object Attribute to Get - Command Message Types 19 — 1D hex 
This byte defines the object attribute to get the value of and return in the response message. 


6-18.5.2.20 Object Attribute to Set — Command Message Types 19 — 1D hex 


This byte defines the object attribute to set to the new value defined by the Attribute Value 
when the Load Data/Start Profile bit transitions from zero to one. 


— 6-83 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 6: Device Profiles, Part 2 
Position Controller Device, Type: 101Hex 

6-18.5.2.21 Command Block Attribute to Get/Set - Command Message Type 1E hex 
This byte defines the attribute of the Command Block Object Instance to get/set, when the 
Load Data/Start Profile bit transitions from zero to one. 

6-18.5.2.22 Command Block Instance to Get/Set - Command Message Type 1E hex 
This byte defines the instance of the Command Block Object for which the attribute is being 
get/set, when the Load Data/Start Profile bit transitions from zero to one. 

6-18.5.2.23 Parameter Instance to Get - Command Message Type 1F hex 
This byte defines the instance of the parameter object to get the value of and return in the 
response message. 

6-18.5.2.24 Parameter Instance to Set - Command Message Type 1F hex 
This byte defines the instance of the parameter object to set to the new value defined by the 
Parameter Value, when the Load Data/Start Profile bit transitions from zero to one. 

6-18.5.2.25 Parameter Value - Command Message Type 1F hex 
This double word defines the value of the parameter to set, when the Load Data/Start Profile bit 
transitions from zero to one. 

6-18.5.3 Response Message Types 


The response message type is defined by byte 03 of the message. Bytes 00, 02 and 03 are the 
same for all response message types. Bytes 01 and 04 through 07 are defined by the Response 
Message Type code in byte 03. 


Table 6-18.26 Response Message Type 01 hex Actual Position - Optional 
0 Enable Reg Level Home Current | General | On Target | Block in Profile in 
Level Direction Fault Position | execution Progress 
Executing Block Number 


Load Block Fault | FE Fault | Negative | Positive | Rev Limit Fault Input 
Complete Limit Limit ue Fault 


Response Axis Number Response Message Type 


7 Actual Position Low Byte 
5 Actual Position Low Middle Byte 
6 Actual Position High Middle Byte 
7 Actual Position High Byte 


Table 6-18.27 Response ae Type 02 hex Command Position - I 
Enable Reg Level Een Current | General | On Ree ee in Profile in 
Level Direction Fault Position | execution Progress 


Executing Block Number 


BR 


2 Load Block Fault | FE Fault | Negative | Positive | Rev Limit Fwd Fault Input 
3 Response Message Type 

4 Commanded Position Low Byte 

5 Commanded Position Low Middle Byte 

6 Commanded Position High Middle Byte 

7 Commanded Position High Byte 
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Table 6-18.28 aaa oS Type 03 hex Actual a - ay 


Byte | Bit7 | 7 | Bits | 5 Bit | Bit3 | | Bit2 | 2 | Bita | 1 Bit 0 
0 Enable Reg ease Home a General | On Target Block i in Profile in 
1 Executing Block Number 
2 Load Block Fault | FE Fault | Negative | Positive | Rev Limit Fwd Fault Input 
3 Response Message Type 
4 Actual Velocity Low Byte 
5 Actual Velocity Low Middle Byte 
6 Actual Velocity High Middle Byte 


7 Actual Velocity High Byte 


Table 6-18.29 Response Message Type 04 hex Command Velocity - Optional 
0 Enable Reg Level Home Current | General | On Target | Block in Profile in 
Level Direction Fault Position | execution Progress 


1 Executing Block Number 

2 Load Block Fault | FE Fault | Negative | Positive | Rev Limit Fwd Fault Input 
3 Response Message Type 

4 Commanded Velocity Low Byte 

5 Commanded Velocity Low Middle Byte 

6 Commanded Velocity High Middle Byte 

7 Commanded Velocity High Byte 


Table 6-18.30 Response Message Type 05 hex Torque - Optional 
0 Enable Reg Level Home Current | General | On Target | Block in Profile in 
Level Direction Fault Position | execution Progress 
1 Executing Block Number 


2 Load Block Fault | FE Fault | Negative | Positive | Rev Limit Fwd Fault Input 
Complete Limit Limit Limit Fault 


3 Response Message Type 
4 Torque Low Byte 

5 Torque Low Middle Byte 

6 Torque High Middle Byte 

iD Torque High Byte 


Table 6-18.31 Response Message Type 06 hex Captured Home Position - — 


Byte| Bic7 | ies | Bies | Bics | Bits | Bie2 | Bit |  Bieo 
0 Enable Reg Level Home Current General | On Target Block i in Profile in 
1 Executing Block Number 

2 Load Block Fault | FE Fault | Negative | Positive | Rev Limit Fwd Fault Input 
Response Message Type 


Home Position Low Byte 
Home Position Low Middle Byte 
Home Position High Middle Byte 

Home Position High Byte 


NI] OQ] ot) RY] 
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Table 6-18.32 eae oS Type 07 hex aS Index Position - — 


Byte | Bit7 | 7 | Bits | 5 Bit | Bit3 | | Bit2 | 2 | Bita | 1 Bit 0 
0 Enable Reg eae Home A General | On Target Block i in Profile in 
1 Executing Block Number 
2 Load Block Fault | FE Fault | Negative | Positive | Rev Limit Fwd Fault Input 
3 Response Message Type 
4 Index Position Low Byte 
5 Index Position Low Middle Byte 
6 Index Position High Middle Byte 


7 Index Position High Byte 


Table 6-18.33 Response Message Type 08 hex Captured Registration Position - Optional 
0 Enable Reg Level Home Current | General | On Target | Block in Profile in 
Level Direction Fault Position | execution Progress 


1 Executing Block Number 

2 Load Block Fault FE Negative | Positive | Rev Limit Fwd Fault Input 
3 Response Message Type 

4 Registration Position Low Byte 

5 Registration Position Low Middle Byte 

6 Registration Position High Middle Byte 

7 Registration Position High Byte 


Table 6-18.34 Response Message Type 14 hex Command/Response Error — Required 
0 Enable Reg Level Home Current | General | On Target | Block in Profile in 
Level Direction Fault Position | execution Progress 
1 Reserved = 0 


2 Load Block Fault | FE Fault | Negative | Positive | Rev Limit Fwd Fault Input 
Complete Limit Limit Limit Fault 


3 Response Message Type 
4 General Error Code 

5 Additional Code 

6 Copy of Command Message Byte 2 

iD Copy of Command Message Byte 3 


Table 6-18.35 Response = Type 19 hex Motor Data Attribute - ann 


0 Enable Reg Level eel Current | General Bom Target eal in Profile in 
Level Direction Fault Position | execution Progress 


1 Motor Data Attribute to Get 

2 Load Block Fault | FE Fault | Negative | Positive | Rev Limit Fwd Fault Input 
3 Response Message Type 

4 Motor Data Attribute Value Low Byte 

5 Motor Data Attribute Value Low Middle Byte 

6 Motor Data Attribute Value High Middle Byte 

7 Motor Data Attribute Value High Byte 
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Table 6-18.36 SS oS Type 1A hex Position Controller a Attribute - Optional 


Byte | Bit7 | 7 | Bits | 5 Bit | Bit | | Bit2 | 2 | Bit1 | 1 Bit 0 
0 Enable Reg eee Home a General | On Target Block i in Profile in 
1 Position Controller Supervisor Attribute to Get 
2 Load Block Fault | FE Fault | Negative | Positive | Rev Limit Fwd Fault Input 
3 Response Message Type 
4 Position Controller Supervisor Attribute Value Low Byte 
5 Position Controller Supervisor Attribute Value Low Middle Byte 
6 Position Controller Supervisor Attribute Value High Middle Byte 


7 Position Controller Supervisor Attribute Value High Byte 


Table 6-18.37 Response Message Type 1B hex Position Controller Attribute - Optional 
0 Enable Reg Level Home Current | General | On Target | Block in Profile in 
Level Direction Fault Position | execution Progress 


1 Position Controller Attribute to Get 

2 Load Block Fault | FE Fault | Negative | Positive | Rev Limit Fwd Fault Input 
3 Response Message Type 

4 Position Controller Attribute Value Low Byte 

5 Position Controller Attribute Value Low Middle Byte 

6 Position Controller Attribute Value High Middle Byte 

7 Position Controller Attribute Value High Byte 


Table 6-18.38 Response Message Type 1C hex Block Sequencer Attribute - Optional 
0 Enable Reg Level Home Current | General | On Target | Block in Profile in 
Level Direction Fault Position | execution Progress 
1 Block Sequencer Attribute to Get 
2 Load Block Fault | FE Fault | Negative | Positive Rev Fwd Fault Input 
Complete Limit Limit Limit Limit Fault 
Response Axis Number Response Message Type 


Block Sequencer Attribute Value Low Byte 
Block Sequencer Attribute Value Low Middle Byte 
Block Sequencer Attribute Value High Middle Byte 
iD Block Sequencer Attribute Value High Byte 


HD) uy RY] 


Table 6-18.39 Response = Type 1D hex Drive Data Attribute - an 


0 Enable Reg Level ee Current | General ees Target bel in Profile in 
Level Direction Fault Position | execution Progress 


1 Drive Attribute to Get 

2 Load Block Fault | FE Fault | Negative | Positive | Rev Limit Fwd Fault Input 
3 Response Message Type 

4 Drive Attribute Value Low Byte 

5 Drive Attribute Value Low Middle Byte 

6 Drive Attribute Value High Middle Byte 

7 Drive Attribute Value High Byte 
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Table 6-18.40 —— Sy Type 1E hex Command Block Attribute - —— 
= | Bit7 | 7 | Bits | 5 Bit | Bit | | Bit2 | 2 | Bita | 1 Bit 0 


Enable Reg eae Home peas General | On Target | Block in Profile in 
Level Direction Fault Position | execution Progress 


Command Block Attribute to Get 


; Load Block Fault | FE Fault | Negative | Positive | Rev Limit Fault Input 
3 Response Message Type 

4 Command Block Attribute Value Low Byte 

5 Command Block Attribute Value Low Middle Byte 

6 Command Block Attribute Value High Middle Byte 

7 Command Block Attribute Value High Byte 


Table 6-18.41 Response Message Type 1F hex Parameter - Optional 
0 Enable Reg Level Home Current | General | On Target | Block in Profile in 
Level Direction Fault Position | execution Progress 


1 Parameter Instance to Get 

2 Load Block Fault | FE Fault | Negative | Positive | Rev Limit Fwd Fault Input 
3 Response Message Type 

4 Parameter Value Low Byte 

5 Parameter Value Low Middle Byte 

6 Parameter Value High Middle Byte 

7 Parameter Value High Byte 


6-18.5.4 Semantics 
6-18.5.4.1 Profile in Progress 


This bit indicates that a profile move is in progress. 


6-18.5.4.2 Block in Execution 


This bit indicates that a block is in execution. The command block that is currently being 
executed is returned in byte 1. 


6-18.5.4.3 On Target Position 


This bit indicates whether or not the motor is on the last targeted position. (1 = Current position 
equals the last target position.) 


6-18.5.4.4 General Fault 
This bit indicates the logical “or” of all fault conditions. 


6-18.5.4.5 Current Direction 


This bit shows the current direction of the motor. If the motor is not moving the bit will 
indicate the direction of the last commanded move. 0 = reverse or negative direction and 1 = 
forward or positive direction. 


6-18.5.4.6 Home Level 
This bit reflects the level of the home input. 


6-18.5.4.7 Reg Level 
This bit reflects the level of the registration input. 


6-18.5.4.8 Enable 
This bit indicates the state of the enable output. A 1 indicates the enable output is active. 


— 6-88 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 6: Device Profiles, Part 2 
Position Controller Device, Type: 104Hex 
6-18.5.4.9 Executing Block # 
This byte defines the currently executing block if the Block In Execution bit is active. 


6-18.5.4.10 Fault Input Fault 
This bit indicates that the fault input is active. 


6-18.5.4.11 Fwd Limit 
This bit indicates that the forward input is active. 


6-18.5.4.12 Rev Limit 
This bit indicates that the reverse input is active. 


6-18.5.4.13 Positive Limit 
This bit indicates that the motor has attempted to travel past the programmed positive limit 
position. This bit remains valid until the motor is moved within the limits or the programmed 
limit value is set greater than the current position. 

6-18.5.4.14 Negative Limit 


This bit indicates that the motor has attempted to travel past the programmed negative limit 
position. This bit remains valid until the motor is moved within the limits or the programmed 
limit value is set less than the current position. 

6-18.5.4.15 FE Fault 


This bit indicates that a following error fault has occurred. This fault occurs when the following 
error, or difference between the commanded and actual position, exceeds the programmed 
allowable following error. 

6-18.5.4.16 Block Fault 


This bit indicates that a block execution fault has occurred. When this happens block execution 
and motion will cease. This bit is reset when Block Sequencer Block Fault Code attribute 
(Block Sequencer class, attribute 5) is read. 

6-18.5.4.17 Load Complete 
This bit indicates that the command data contained in the command message has been 
successfully loaded into the device. 

6-18.5.4.18 | Response Message Type 
This byte defines the Response Message Type 


6-18.5.4.19 Response Axis Number 
These three bits report the Produced Axis Connection attribute of the Position Controller 


Supervisor class. This attribute value specifies the instance number of all of the axis objects 
whose data is contained in the I/O response message. 
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Table 6-18.42 Response Axis Numbers 


Response Axis Byte 3 


1 a ee ee ee 0 


AluUypR]wy]rm 
RPILOlLRPITOl[RPIloOf[rR 


1 
7 

Note that axis 1 can be reported as either binary 0 or 1. Axis zero is not allowed. 
6-18.5.4.20 Actual Position - Response Message Type 01 hex 

This double word reflects the actual position in position units. If position feedback is not used, 

this word will report the commanded position. 
6-18.5.4.21 Commanded Position - Response Message Type 02 hex 

This double word reflects the commanded or calculated position in position units. 
6-18.5.4.22 Actual Velocity - Response Message Type 03 hex 

This double word reflects the actual velocity in profile units. 
6-18.5.4.23. Command Velocity - Response Message Type 04 hex 

This double word reflects the commanded or calculated velocity in profile units. 
6-18.5.4.24 Torque - Response Message Type 05 hex 

This double word reflects the torque. 
6-18.5.4.25 Home Position - Response Message Type 06 hex 

This double word reflects the captured home position in position units. 
6-18.5.4.26 Index Position - Response Message Type 07 hex 

This double word reflects the captured index position in position units. 
6-18.5.4.27 Registration Position - Response Message Type 08 hex 

This double word reflects the captured registration position in position units. 
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6-18.5.4.28 |General Error Code — Response Message Type 14 hex 


This byte identifies an error has been encountered. The table below summarizes specific 
behavior for the Position Controller Profile. See Appendix B for a complete list of General 
Error codes. 


Table 6-18.43 Additional Error Codes for Position Controller Profile 


General | 4 dditional rth : 
Error Error Description Semantics 
Code Code 


O8nex O1nex Service Not Supported Command Message type not supported. 
Additional code 01 takes precedence over 
additional code 02. ' 


Service Not Supported Response message type not supported. 


es 
O5 nex Ol nex Path Destination Unknown | Consumed axis number was requested that does 
not exist in the drive. 
O2 nex Path Destination Unknown | A produced axis number was requested that does 
not exist in the drive. 
id Attr 


O9 hex F Invalid Attribute Value Load value is out of range. 


nex 
OE nex FFhex Attribute not Settable A request to modify a non-modifiable attribute 
was received. 
13nex FFhex Not Enough Data I/O command message contained fewer than 8 
bytes. 
ex 


14hex Attribute Not Supported Attribute specified in request was not supported. 


1 If Response Message Type is supported and Command Message Type is not supported, a 
General Error Code 08, Additional Code 01 shall be returned. 


6-18.5.4.29 Additional Code — Response Message Type 14 hex 


This byte contains an object/service-specific value that further describes the error condition. If 
the responding object has no additional information to specify, then the value FFhex is placed 
within this field. 


6-18.5.4.30 Attribute Value — Response Message Types 19 — 1E hex 


This double word reflects the value of the attribute to get. 


6-18.5.4.31 Object Attribute to Get — Response Message Types 19 — 1E hex 
This byte defines the object attribute from which to get the value. 


6-18.5.4.32 Parameter Instance to Get - Response Message Type 1F hex 
This byte defines the instance of the parameter object to get the value of and return in the 
response message. 

6-18.5.4.33 Parameter Value - Response Message Type 1F hex 
This double word reflects the value of the parameter to get. 
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6-18.6 Mapping I/O Message Data Attribute Components 


The following table indicates the I/O Data Attribute mapping for the Position Controller Profile 
Command Messages. 


Table 6-18.44 I/O Assembly Data Mapping - Command Messages 


Data Component Instance Data 
Name a Number | Name__ Type 


Load Data/ Start Position Controller 1-7 Load Data/ Profile oot 
Profile Handshake 


Start Block Block Sequencer Block Execute | 2 | BOOL 
Incremental Position Controller BOOL 


Direction BOOL 
Smooth Stop BOOL 
Hard Stop BOOL 
Registration Arm BOOL 
Enable BOOL 
Block # USINT 


Number Class Number 

Type Type 

Response Axis Position Ctrl Supervisor 2Anex 1-7 Produced Axis 33 | USINT 
Number Class Number 

Type Type 


Target Position | 6 | DINT 
Target Velocity Peston Contoler | 25n2| 1-7 —| Target velocity [7 DINT 
Acceleration | Position Controller | 25nex | __1-7__| Acceleration |_ 8_| DINT 
Deceleration | Position Controller | 25yex | __1-7__| Deceleration _—|_9_| DINT 
Torque Position Controller __| 25a, |__1-7_} Torque __] 25 | DINT 


Parameter Value OF hex 1-255 Parameter Value Determined by 


instance of 
parameter 
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The following table indicates the I/O Data Attribute mapping for the Position Controller Profile 
Response Messages. 


Table 6-18.45 I/O Assembly Data Mapping — Response Messages 


Data Component Instance 
[Names| Number [Name | # | 


Position Ctrl Supervisor 24nex 1-7 Registration Input 22 
Level 


Position Cul Supervisor | 24e, | 1-7 | Fauktinput____| 8 | 


Name 
Profile in Progress 
Block in Execution 
On Target Position 
General Fault 
Direction 
Home Level 
Reg Level 


Enable State 
Executing Block # 
Fault Input Fault 
Fwd Limit 

Rev Limit 
Positive Limit 


Negative Limit 
FE Fault 


Block Fault 
Load Complete 


Response Axis 
Number 


Response Message 
Type 
Actual Position 


Commanded 
Position 


Actual Velocity 


Commanded 
Velocity 


Torque 
Home Position 
Index Position 


Registration 
Position 


Parameter Value 


Position Controller 


Position Controller 


25hex 1-7 Positive Limit 56 
Triggered 

25hex 1-7 Negative Limit 57 
Triggered 


Position Controller hex 1-7 Following Error 47 
Fault 


Block Sequencer Block Fault 

Position Controller Date 1-7 Load Data 58 
Complete 

Position Ctrl Supervisor 2Anex Produced Axis 33 

Class Number 

Position Ctrl Supervisor 24nex 1-7 Rspnc Message 7 
Type 


Position Controller hex 1-7 Commanded 15 
Position 


Position Controller Actual Velocity 


ne: 
Position Controller hex 1-7 Commanded 16 
Velocity 


Position Ctrl Supervisor 
Position Ctrl Supervisor 


Position Ctrl Supervisor 
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Index Position 


Registration 
Position 


Parameter Value 


ODVA & ControlNet International, Ltd. 


Data 

Type 
BOOL 
BOOL 
BOOL 
BOOL 
BOOL 
BOOL 
BOOL 


BOOL 
USINT 
BOOL 
BOOL 
BOOL 
BOOL 


BOOL 
BOOL 


BOOL 
BOOL 


USINT 


USINT 


Determined by 
instance of 
parameter 
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6-19 Motor Overload Device 


Device Type: 03 Hex 

The Motor Overload device profile is part of a “Hierarchy of Motor Control Devices” that are 
supported by CIP. This hierarchy includes: 

e Contactors, Overloads, and Across the Line Motor Starters 

e §6Softstarters 

AC/DC Drives 

e Servo Drives 


Devices within this hierarchy use a common Control Supervisor object to control state behavior 
of the device. Devices within this hierarchy also support a hierarchy of “IO Assembly 
Instance” definitions which are used to pass control and status information to and from a 
device. Assembly instances are numbered so that each device type is assigned a range of 
instance numbers, with higher functionality devices supporting higher instance numbers. 
Devices within the hierarchy can choose to support some instance numbers that are lower than 
theirs in the hierarchy. For example, an AC Drive may choose to support some instances that 
are defined for Across the Line Motor Starters. This makes it easier to interchange drives and 
starters within a system. 


This profile makes Motor Starters of the same device type inter-operable, but not directly 
interchangeable without doing configuration through a unit’s local interface, a network 
configuration tool or other means of configuring outside the CIP interface. 


6-19.1 Object Model 


The Object Model in Figure 6-19.2 represents a Motor Overload. The table below indicates: 
e the object classes present in this device 

e whether or not the class is required 

e the number of instances present in each class 


Table 6-19.1 Objects Present in a Motor Overload Device 


Object Class Optional/Required # of Instances 


CIP Common Required Objects See Section 6-2.1 
Parameter - 
Control Supervisor 1 
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Figure 6-19.2 Object Model for a Motor Overload Device 


Parameter 


Application 


Supervisor f 


Message 
Router 


Assembly Network 
Specific Link 


Object(s) 


Input 
Instance 


Output 
Instance 


Connection Manager 
or Connection Object 


I/O Data 


eS) Optional CD Required CIP Network 


6-19.2 How Objects Affect Behavior 


The objects for this device affect the device’s behavior as shown in the table below. 


Table 6-19.3 Object Effect on Behavior 


Object Effect on behavior 
CIP Common Required | See Section 6-2.2 for details. 
Assembly Defines I/O data format 
Parameter Provides a public interface to device configuration data 
Control Supervisor Manages motor functions and operational states 
Overload Implements overload 
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6-19.3. Defining Object Interfaces 


The objects in the Motor Overload have the interfaces listed in the following table: 


Table 6-19.4 Object Interfaces 


Object Interface 
CIP Common Required | See Section 6-2.3 for details. 
Assembly I/O Connection or Message Router 
Parameter Message Router 


Control Supervisor Message Router, Assembly or Parameter Object 
Overload Message Router, Assembly or Parameter Object 


6-19.4 Contactor Interface and Behavior 
Figure 6-19.5 Behavior Diagram 


L1O <a a 


L2 aaa OT2 


L3O COO 13 
0x2C-1-8 | CurrentL1 


0x2C-1-9 |CurrentL2 


0x2C-1-10 |CurrentL3 


Ox2C-1-5_| AvgCurrent 
RST Overload Ox2C-1-6 |%PhImbal 
Function { 
0x2C-1-7 |%Thermal 


FaultRst 


0x29-1-12 


Local Fault Rst 


Vendor Specific 
Reset Logic 


TRIP 


Faulted/Trip 
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6-19.5 I/O Assembly Instances 


The IO Assembly Instance definitions in this section define the format of the “data” attribute 
(attribute 3) for IO Assembly Instances. Through the use of predefined instance definitions, IO 
Assemblies support a hierarchy of motor control devices. The device hierarchy includes motor 
starters, soft starters, AC and DC drives, and servo drives. Assembly Instances are numbered 
within the hierarchy so that each device type is assigned a range of Assembly Instance 
numbers, with higher functionality devices supporting higher instance numbers. Devices in the 
hierarchy can choose to support instance numbers that are lower than theirs in the 
hierarchy. For example a Softstart may choose to support some IO Assemblies that are 
defined for Overload. The following table shows the Assembly Instance numbering for the 
motor control device hierarchy. 


Table 6-19.6 I/O Assembly Instances — Motor Control Device Hierarchy 


Profile Instance Range 
Contactors, Overloads and 1-19 
Starters 50-69 
AC/DC Drive 20-29 


Servo Drive 


The following IO Assembly Instances are defined for Overloads. 
Table 6-19.7 I/O Assembly Instances - Overloads 


Instance Name 


2 Basic Overload 
50 Basic Overload 
51 Extended Overload 


If a bit is not used in an IO Assembly, it is reserved for use in other Assemblies. Reserved bits 
in Output Assemblies are ignored by the consuming device. Reserved bits in Input Assemblies 
are set to zero by the producing device. 


6-19.5.1 | Connection Paths to I/O Assembly Instances 


The IO Assembly Instances are chosen for IO Connections by setting the 
“produced_connection_path” (attribute 14) and “consumed_connection_path” (attribute 16) 
attributes in the appropriate connection object. 

Motor Control Devices use the Symbolic Segment Type (see Appendix C) to specify paths to 
the IO Assembly Instances in the Motor Control Hierarchy. IO Assembly Instances are 
represented by ASCII strings that contain the hex number of the Assembly Instance whose path 
is to be chosen. 
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6-19.6.2 


6-19.7 
6-19.7.1 
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The following example shows the Symbolic Segment used to specify Output Assembly 
Instance 20 (14 hex). 


Table 6-19.8 Symbolic Segment Example 


Segment Type First Character Second Character 
0131/0001 +0 00110001 00110100 
Segment Symbol size in ASCII 1 (31 hex) ASCII 4 (34 hex) 

type bytes (2 bytes) 
(symbolic) 


I/O Assembly Data Attribute Format 
Output Assembly Data Attribute Format 
Table 6-19.9 I/O Assembly Instance 2: Basic Overload 


This is the only required output assembly for the device type Motor Overload (03hex) 
Byte Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 


0 Reserved 
Input Assembly Data Attribute Format 
Table 6-19.10 I/O Assembly Instance 50: Basic Overload 


This is the only required input assembly for the device type Motor Overload.(03hex). 
Trip 


Table 6-19.11 I/O Assembly Instance 51: Extended Overload 


This assembly uses some optional attributes 


Byte Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
0 Reserved | Reserved | Reserved | Reserved | Reserved | Reserved | Warning | Faulted/ 
Trip 


Mapping I/O Assembly Data Attribute Components 


Mapping for Output Assembly Data Components 
Table 6-19.12 Output Assembly Data Mapping 


Data Name Class Name Class Instance Attribute Attribute 
Number Name Number 
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Mapping for Input Assembly Data Components 
Table 6-19.13 Input Assembly Data Mapping 


Data Name Class Name Class Instance Attribute Attribute 
Number Name Number 


Faulted/ Trip Control Supervisor 10 


Defining Device Configuration 


Public access to the Control Supervisor Object and the Overload Object must be supported for 
configuration of a Motor Overload devices. If supported, optional Parameter Objects may be 
used to access the various configuration attributes in the Control Supervisor Object and the 
Overload Object. 
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6-20 Weigh Scale Device 


The profile for this device type will be defined by the Open DeviceNet Vendor Association, 
Inc.and ControlNet International. 
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6-21 Encoder Device 
Device Type: 22 Hex 
6-21.1 Introduction 


Encoders are used to detect positions of any kind of machines. These devices could be used for 
following applications: Sensing of angles, distances, tracks, velocity and motion control. This 
profile covers the measuring principle of absolute and incremental systems as well as the 
mechanical specification of rotary and linear devices. 


6-21.2 Object Model 


The Object Model in Figure 6-21.2 represents an encoder. The table below indicates: 
e = The object class 

e Whether or not the class is required 

e The number of instances present in each class 


Table 6-21.1 Objects Present in an Encoder Device 


Object Class # of Instances 

CIP Common Required Objects See Section 6-2.1 

Assembly at least 1 I/O input assembly 
Position Sensor 1 


Figure 6-21.2 Object Model for an Encoder Device 
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6-21.3. How Objects Affect Behavior 


Objects supported for the encoder affect the device’s behavior as shown in the table below. 


Table 6-21.3 Object Effect on Behavior 


Object Effect on Behavior 
CIP Common Required | See Section 6-2.2 for details. 
Assembly Defines I/O data format 
Parameter Provides a public interface to the device's configuration data 
Position Sensor Affects Value (attribute) 


6-21.4 Defining Object Interfaces 
Objects supported for the encoder have the interfaces listed in the table below. 
Table 6-21.4 Objects Interfaces 


Object Interface 
CIP Common Required | See Section 6-2.3 for details. 


Assembly I/O Connection or Message Router 
Parameter Message Router 
Position Sensor Message Router, Assembly Object or Parameter Object 


6-21.5 I/O Assembly Instances 


The following table identifies the I/O Assembly instances, which should be supported by the 
encoder device. 


Table 6-22.5 I/O Assembly Instances 


Number Required/Optional Type Name 


1 Position Value 1 Axis 
2 Position Value 1 axis & Warning Flag 1 axis & Alarm 
Flag 1 axis 
3 Position Value 1 axis & Velocity 1 axis 
Position Value 1 axis & Position Value 2 axis 
5 Optional Input Position Value 1 axis & Velocity 1 axis 
& 


Position Value 2 axis & Velocity 2 axis 
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Encoder Device, Type: 221ex 
6-21.6 I/O Assembly Data Attribute Format 


The I/O assembly data attributes have the format shown below. 


Table 6-21.6 I/O Assembly Data Attribute Format 


1 iG -- =) Position Value 1 axis (low byte) 
1 Position Value 1 axis 
2 Position Value 1 axis 

Position Value 1 axis (high byte) 

2 lo | Position Value 1 axis (low byte) 


—_ Position Value 1 axis 


Position Value 1 axis 
a Position Value 1 axis (high byte) 


4 Warning | Alarm 
Vendor Specific Reserved by CIP Flag 1 Flag 1 
Axis Axis 
3 lo | Position Value 1 axis (low byte) 


Position Value 1 axis 
Position Value 1 axis 
Position Value 1 axis (high byte) 
Velocity 1 axis (low byte) 
Velocity 1 axis 
le | Velocity 1 axis 
Velocity 1 axis (high byte) 
4 lo | Position Value 1 axis (low byte) 
_ Position Value 1 axis 
Position Value 1 axis 
i Position Value 1 axis (high byte) 
Position Value 2 axis (low byte) 
Position Value 2 axis 
le | Position Value 2 axis 
Position Value 2 axis (high byte) 
5 lo | Position Value 1 axis (low byte) 


Position Value 1 axis 
2 


Position Value 1 axis 


Position Value 1 axis (high byte) 
Velocity 1 axis (low byte) 
Velocity 1 axis 

le | Velocity 1 axis 

Velocity 1 axis (high byte) 

is | Position Value 2 axis (low byte) 


lo | Position Value 2 axis 


10 Position Value 2 axis 
Position Value 2 axis (high byte) 
Velocity 2 axis (low byte) 
Velocity 2 axis 
Velocity 2 axis 


Velocity 2 axis (high byte) 
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6-21.7 


6-21.8 


6-21.9 


Encoder Device, Type: 221ex 


Mapping I/O Assembly Data Attribute Components 


The following table indicates the I/O Assembly Data Attribute mapping for the Encoder 
Profile. 


Table 6-21.7 I/O Assembly Data Mapping 


Data Component Instance 
Name Name Number 


Attribute 


Namier 


Position Value 1 axis Position 


Position 10 
Sensor Value 
Velocity 1 axis Position re | 


“ , 
23hex 1 Velocity 24 
Sensor 
Warning Flag 1 axis Position 23hex 1 Warning 49 
Sensor Flag 
Alarm Flag 1 axis Position 2Bhex 1 Alarm Flag | 46 
Sensor 
23 Position 10 


Position Value 2 axis Position hake 
Sensor Flag 

Velocity 2 axis Position 23hex 1 Velocity 24 
Sensor 


Defining Device Configuration 


Public access to the Position Sensor Object must be supported for configuration of an encoder 
device. If supported, the optional Parameter Objects may be used to access the various 
configuration attributes in the Position Sensor Object. 


Encoder devices may contain (but are not limited to) any of the Parameter Object instances 
listed in the table below. Suggested parameter names are also given in the table. The set of 
parameters instances that are supported by a drive should be numbered sequentially with lower 
instance numbers assigned to parameters that appear earlier in the table. Vendor specific 
parameter instances should be numbered sequentially following the instances that appear in the 
following table. 

Parameter Object instances may be implemented as EDS file definitions, parameter stubs, or 
full parameter objects. See Chapter 5 of the CIP Common specification for a definition of the 
Parameter Object and an explanation of how it is used for configuration. 


Mapping Parameter Object Data 
The following table indicates the Parameter Object data mapping for encoder devices. 


Table 6-21.8 Parameter Object Data Mapping 


Configuration Parameter Instance Attribute 
Name Number Rabe 


Direct Counting Toggle Position Sensor 2 Sie 1 Direction 12 
Counting Toggle 


Commissioning Diagnostic | Position Sensor 23hex Commissioning 12 
Control Diagnostic 


Control 


Scaling Function Control Position Sensor 23hex 1 Scaling Function 14 
Control 
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Configuration Parameter Instance 


Name 


Total Measuring Range in Position Sensor 23hex 


measuring units 


Position Measuring 
Increment 


Preset Value 
Position Value 1 axis 
Position Value 2 axis 


Operating Status 


Physical Resolution Span 23hex 


Number of Span 
Alarm Flag 1 axis 
Alarm Flag 2 axis 
Alarms 


Supported Alarms 


Warning Flag 1 axis 
Warning Flag 2 axis 
Warnings 


Supported Warnings 


Position Sensor 


N 

e¥) 
> 
@ 
~ 


is 


7 
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Attribute 


Total Measuring 
Range in 
measuring units 


Position 
Measuring 
Increment 


Preset Value 


Position Value 


Position Value 


resolution span 


Alarm Flag 


Alarms 


Supported 
Warnings 


17 


18 
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6-22 Resolver Device 


Device Type: 09hex 


A Resolver mechanically or otherwise detects the absolute position of a shaft. The position 
information is represented as a binary integer value. 


6-22.1 Object Model 


The Object Model in figure 6-22.2 represents a resolver. The table below indicates 
e the object classes present in this device 

e whether or not the class is required 

e the number of instances present in each class 

Chapter 5, The CIP Object Library, provides more details about these objects. 


Table 6-22.1 Objects Present in a Resolver Device 


Object Class # of Instances 

CIP Common Required Objects See Section 6-2.1 

Assembly at least 1 I/O input assembly 
Parameter 4 

Position Sensor 1 


Figure 6-22.2 Object Model for a Resolver 


Parameter Class 


Position 
Sensor Object 


Identity Object 


Message 
Router 


Configuration 


Assembly Class 


Connection Manager 
or Connection Obje 


Network 
Specific Link 
Object(s) 


C Required 


CIP Network 
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6-22.2 


6-22.3 


6-22.4 


Resolver Device, Type: 091ex 
How Objects Affect Behavior 


The objects in this device affect the device's behavior as shown in the following table. 
Table 6-22.3 Object Effect on Behavior 

Object 
CIP Common Required 


Effect on Behavior 


See Section 6-2.2 for details. 


Assembly Defines I/O and/or configuration data format 


Parameter Provides a public interface to the device's configuration data 


Affects Value (attribute), Cam (attribute) 


Defining Object Interfaces 


Position Sensor 


The objects in this device have the interfaces listed in the following table. 
Table 6-22.4 Objects Interfaces 


Object Interface 

CIP Common Required | See Section 6-2.3 for details. 
Assembly I/O Connection or Message Router 
Parameter 


Message Router 
Position Sensor 


Message Router, Assembly Object or Parameter Object 
I/O Assembly Instances 


The following table identifies the I/O assembly instance supported by the Resolver device. 
Table 6-22.5 I/O Assembly Instances 


Number Type Name 
2 Value/Cam 
3 SetZero 


*At least 1 input assembly is required 
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Resolver Device, Type: 09+ex 


6-22.5 I/O Assembly Data Attribute Format 
The I/O Assembly Data Attributes have the format shown below. 
Table 6-22.6 I/O Assembly Data Attribute Format 


jo 


Reserved (zero) 


Reserved (zero) SetZero 


6-22.6 Mapping I/O Assembly Data Attribute Components 


The following table indicates the I/O Assembly Data Attribute mapping for the Resolver 
device. 


Table 6-22.7 I/O Assembly Data Mapping 


Data Component | Class Instance Attribute 
Name Number Number 
Value Position 2Bhex 
Sensor 
CAM Position 23hex 
Sensor 
SetZero Position 23h ex 
Sensor 


6-22.7 Configuration Assembly Instances 


at 


The following table identifies the configuration assembly instance supported by the Resolver 
device. 


Table 6-22.8 Configuration Assembly Instances 


Number Bede elo neon Name 
a Without CAM 
a With CAM 
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6-22.8 


6-22.9 


6-22.10 


Resolver Device, Type: 09x 


Configuration Assembly Data Attribute Format 


The Configuration Assembly Data Attribute has the format shown below. 
Table 6-22.9 Configuration Assembly Data Format 


40 10 _| Value Bit Resolution 


41 10 _| Value Bit Resolution 


Mapping Configuration Assembly Data Attribute Components 


The following table indicates the configuration Assembly Data Attribute mapping for the 
Resolver device. 


Table 6-22.10 Configuration Assembly Data Mapping 


Data Component Instance Attribute 
Name Number Naber 


Resolution Position 23hex 1 Bit 5 
Sensor Resolution 
Zero Offset Position 2B hex 1 Zero Offset 6 
Sensor 
CAM Low Limit Position 2Bhex 1 CAM Low 7 
Sensor 
CAM High Limit Position 23hex 1 CAM High 8 
Sensor 


Defining Device Configuration 


Public access to the Position Sensor Object by the Message Router must be supported for 
configuration of this device type. If supported, the optional Parameter Object may be used to 
access the device type's configuration parameters. 


If the Parameter Object is supported it must support a minimum of the Parameter Stub 
attributes, and may optionally support any or all of the Full Parameter Object attributes. 
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Resolver Device, Type: 09x 
6-22.10.1 Parameter Object Instances 
The following table indicates the Parameter Object Instances supported by the Resolver device. 
Table 6-22.11 Parameter Object Instances Supported 
Number Name 
1 Value Bit Resolution 
2 Zero Offset 
3 CAM Low Limit 
4 CAM High Limit 
6-22.10.2 Mapping Parameter Object Data 
The following table indicates the Parameter Object data mapping for the Resolver device. 


Table 6-22.12 Parameter Object Data Mapping 


Configuration Parameter Instance 
Name Number 


Attribute 


Ramiber 
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Resolver Device, Type: 09x 


6-22.10.3 Configuration Parameter Definitions 


The following sections of an example EDS show the information necessary to define the 
configuration parameters for a Resolver device. 


[ParamClass] 


MaxInst=4 
Descriptor=0x09 
CfgAssembly=2 


$Max Instances 
$Parameter Class Descriptor 


$Configuration Assembly Instance 


[Params] 

Param1= $Resolution parameter 
0, $Data placeholder 
6, "20 23 24 01 30 05", $Path size and path to attribute 
0x0000, $Descriptor 
8, 1, $Data type and size (USINT) 
"Bit Resolution", $Name 
"Bits", $Units 
Bus $(not used) 
1, 32, (vendor specific), $Min, max and default values 
0, 0, 0, 0, 0, 0, 0, 0, 0; $(not used) 

Param2= $Zero Offset parameter 
0, $Data placeholder 
6, "20 23 24 01 30 06", $Path size and path to attribute 
0x0000, $Descriptor 
9, 4, $Data type and size (UDINT) 
"Zero Offset", $Name 
me $Units (none) 
ms $(not used) 
0, OXFFFFFFFF, 0, $Min, max and default values 
0, 0, 0, 0, 0, 0, 0, 0, 0; $(not used) 

Param3= $CAM Low Limit 
0, $Data placeholder 
6, "20 23 24 01 30 07", $Path size and path to attribute 
0x0000, $Descriptor 
9, 4, $Data type and size (UDINT) 
"CAM Low Limit", $Name 
mm $Units (none) 
me $(not used) 
0, OXFFFFFFFF, 0, $Min, max and default values 
0, 0, 0, 0, 0, 0, 0, 0, 0; $(not used) 

Param4= $CAM High Limit 
0, $Data placeholder 
6, "20 23 24 01 30 08", $Path size and path to attribute 
0x0000, $Descriptor 
9, 4, $Data type and size (UDINT) 
"CAM High Limit", $Name 


we 
» 
we 


0, OxFFFFFFFF, 0, 
0, 0, 0, 0, 0, 0, 0, 0, 0; 


$Units (none) 

$(not used) 

$Min, max and default values 
$(not used) 
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6-22.11 Effect of Configuration Parameters on Behavior 


The configuration parameters affect the device's behavior as shown below. 


Table 6-22.13 Configuration Parameter Effect on Behavior 


Parameter Effect on behavior 
Bit Resolution Sets the number of significant bits in the Value Attribute of the Position 
Sensor Object 
Zero Offset Sets the zero point for the Value Attribute of the Position Sensor Object 
CAM Low Sets the low threshold for the CAM Attribute of the Position Sensor Object 
CAM High Sets the high threshold for the CAM Attribute of the Position Sensor Object 
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Control Station Device, Type: Not Assigned 


6-23 Control Station Device 


The profile for this device type will be defined by the Open DeviceNet Vendor Association, 
Inc. and ControlNet International. 
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Message Display Device, Type: Not Assigned 


6-24 Message Display Device 


The profile for this device type will be defined by the Open DeviceNet Vendor Association, 
Inc. and ControlNet International. 
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Circuit Breaker Device, Type: Not Assigned 


6-25 Circuit Breaker 


The profile for this device type will be defined by the Open DeviceNet Vendor Association, 
Inc. and ControlNet International. 
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6-26 Pneumatic Valve Device 


Device Type 1B hex 


This Device Profile defines minimum requirements for a Pneumatic Valve Manifold with one 
or more solenoid points and ability to support optional discrete input points. 


6-26.1 Object Model 


The Object Model is illustrated in Figure 6-26.2 and the object classes are described in the 
following table: 


Table 6-26.1 Objects Present in a Pneumatic Valve Device 


Object Classes # of Instances 
CIP Common Required Objects [es I ee il See Section 6-2.1 
Connection or Connection Manager | ss Required 2 or more * 
Discrete Output *** 1 or more * 
Parameter Vendor Specific 


* Depends on the level of I/O support provided by the product 
** Discrete Input Class includes optional solenoid status points and/or optional discrete input points. 
*** Discrete Output Class includes the solenoid valve points. 


Figure 6-26.2 Object Model for a Pneumatic Valve Manifold 


VALVE MANIFOLD 
Solenoid Channels _ General Purpose 
Discrete Input Points 


Discrete Input Point 


Discrete Output Point 


0) (1) (2) ee 1) (2) 2 ee. 


Parameter 
Objects 


Message Router 


Network 
Specific Link 
Object(s) 


Connection 
Class S 


CIP Network 


@ Optional >) Required 
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6-26.2 


6-26.3 


6-26.4 


Pneumatic Valve Device, Type: 1Buex 


How Objects Affect Behavior 
The objects for this device affect its behavior in the following manner: 


Table 6-26.3 Object Effect on Behavior 


Object Classes Effect on Behavior 
Identity Supports the Reset Service 
Message Router No affect 
DeviceNet Configures port attributes 
Assembly Defines I/O data format 
Connection Contains the number of logical ports 
Discrete Input Defines the behavior of solenoid status and discrete input points 
Discrete Output Defines the behavior of solenoid output points 
Parameter Provides a public interface to device configuration data 


Defining Object Interfaces 
Table 6-26.4 Object Interfaces 


Object Classes Interface(s) 
CIP Common Required | See Section 6-2.3 for details. 
Assembly Message Router or I/O Connection 
Discrete Input Message Router or Assembly Object 
Discrete Output Message Router or Assembly Object 
Parameter Message Router or Assembly Object 


I/O Assembly Instances 
The following table defines the Solenoid Status (Input type) assembly instances: 
Table 6-26.5 I/O Assembly Instances — Solenoid Status 


Instance Number Type Name 

Input 1 Solenoid Status 

Input 2 Solenoid Status Points 
Input 4 Solenoid Status Points 
Input 8 Solenoid Status Points 
Input 16 Solenoid Status Points 
Input 24 Solenoid Status Points 
Input 32 Solenoid Status Points 
Input 48 Solenoid Status Points 
Input 64 Solenoid Status Points 


BR 
Oo 


OL MOI;N| Dm] my) BR] wWwTNynire 


Input L Solenoid Status Points 
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Pneumatic Valve Device, Type: 1Buex 
The following table defines the Discrete Input (Input type) assembly instances: 
Table 6-26.6 I/O Assembly Instances — Discrete Input 


Instance Number Type Name 
11 Input 1 Discrete Input Point 

12 Input 2 Discrete Input Points 

13 Input 4 Discrete Input Points 

14 Input 8 Discrete Input Points 


15 Input 16 Discrete Input Points 
16 Input 24 Discrete Input Points 
17 Input 32 Discrete Input Points 
18 Input 48 Discrete Input Points 
19 Input 64 Discrete Input Points 


20 Input M Discrete Input Points 


The following table defines the Input type instances where Solenoid Status points and 
Discrete Input points are both present. 


Table 6-26.7 I/O Assembly Instances — Solenoid Status & Discrete Input 


30 Reserved by CIP 


Instance Number Name 

21 1 Solenoid Status Points + 1 Discrete Input Points 
22 2 Solenoid Status Points + 2 Discrete Input Points 
23 4 Solenoid Status Points + 4 Discrete Input Points 
24 8 Solenoid Status Points + 8 Discrete Input Points 
25 16 Solenoid Status Points + 16 Discrete Input Points 
26 24 Solenoid Status Points + 24 Discrete Input Points 
27 32 Solenoid Status Points + 32 Discrete Input Points 
28 48 Solenoid Status Points + 48 Discrete Input Points 
29 64 Solenoid Status Points + 64 Discrete Input Points 

ed 


The following table defines the Solenoid Output (Output type) assembly instances: 
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6-26.5 
6-26.5.1 


Pneumatic Valve Device, Type: 1Buex 


Table 6-26.8 I/O Assembly Instances — Solenoid Output 


Instance Number Name 
31 Single Solenoid Output Point 
32 2 Solenoid Output Points 

33 4 Solenoid Output Points 

34 8 Solenoid Output Points 

35 16 Solenoid Output Points 
36 24 Solenoid Output Points 
37 32 Solenoid Output Points 
38 48 Solenoid Output Points 
39 64 Solenoid Output Points 
40 N Solenoid Output Points 

41 ~ 99 |--_—_—_| Reserved by CIP 

100 ~ 199 |--_—_| Vendor Specific 


I/O Assembly Data Attribute Format 


The I/O Assembly data attribute for Solenoids Status Data is shown below: 
Table 6-26.9 I/O Assembly Data Attributes — Solenoid Status Data 


Reserved Solenoid 
Status] 

Reserved Solenoid | Solenoid 
Status2 | Status1 

Reserved Solenoid | Solenoid | Solenoid | Solenoid 
Status4 Status3 Status2 | Status1 

Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status8 Status7 Status6 Status5 Status4 Status3 Status2 | Status1 

Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status8 Status7 Status6 Status5 Status4 Status3 Status2 | Status1 


Instance 


1 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status16 | Status15 | Status14 | Status13 Status12 | Status11 


Solenoid | Solenoid 
Status10 | Status9 


Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status8 Status7 Status6 Status5 Status4 Status3 Status2 | Status1 


1 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status16 | Status15 | Status14 | Status13 Status12 | Status11 
2 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status24 |Status23 | Status22 | Status21 Status20 | Status19 
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Solenoid | Solenoid 
Status18 | Status17 
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Instance 


Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status8 Status7 Status6 Status5 Status4 Status3 Status2 | Status1 
1 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status16 |Status15 | Status14 | Status13 Status12 | Status11 Status10 | Status9 
2 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status24 | Status23 | Status22 | Status21 Status20 | Status19 Status18 | Status17 
3 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status32 | Status31 | Status30 | Status29 Status28 | Status27 Status26 | Status25 


Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status8 Status7 Status6 Status5 Status4 Status3 Status2 | Status1 

1 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status16 | Status15 | Status14 | Status13 Status12 | Status11 Status10 | Status9 

2 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status24 | Status23 | Status22 | Status21 Status20 | Status19 Status18 | Status17 

3 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status32 | Status31 | Status30 | Status29 Status28 | Status27 Status26 | Status25 

4 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status40 | Status39 | Status38 | Status37 Status36 | Status35 Status34 | Status33 


5 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status48 |Status47 | Status46 | Status45 Status44 | Status43 Status42 | Status41 


Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status8 Status7 Status6 Status5 Status4 Status3 Status2 | Status1 

1 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status16 | Status15 | Status14 | Status13 Status12 | Status11 Status10 | Status9 

2 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status24 | Status23 | Status22 | Status21 Status20 | Status19 Status18 | Status17 

3 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status32 | Status31 | Status30 | Status29 Status28 | Status27 Status26 | Status25 

4 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status40 | Status39 | Status38 | Status37 Status36 | Status35 Status34 | Status33 

5 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status48 |Status47 | Status46 | Status45 Status44 | Status43 Status42 | Status41 
Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status56 |Status55 | Status54 | Status53 Status52 | Status51 Status50 | Status49 

wi Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status64 |Status63 | Status62 | Status61 Status60 | Status59 Status58 | Status57 


Solenoid | Solenoid | Solenoid | Solenoid | Solenoid |Solenoid | Solenoid | Solenoid 
Status8 Status7 Status6 Status5 Status4 Status3 Status2 | Status1 
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6-26.5.2 


Pneumatic Valve Device, Type: 1Buex 


The I/O Assembly data attribute for General Purpose Discrete Input Data is shown 
below: 


Table 6-26.10 I/O Assembly Data Attributes — Gen Purpose Discrete Input Data 


Instance Bit 7 i Bit 0 


11 Reserved Discrete 
Input 1 


12 Reserved Discrete Discrete 
Input2 Input1 

13 Reserved Discrete | Discrete Discrete Discrete 
Input4 Input3 Input2 Input1 

14 Discrete | Discrete | Discrete Discrete | Discrete | Discrete Discrete Discrete 
Input8 Input7 Input6 Input5 Input4 Input3 Input2 Input1 


15 Discrete | Discrete | Discrete Discrete | Discrete | Discrete Discrete Discrete 
Input8 Input7 Input6 Input5 Input4 Input3 Input2 Input1 
1 Discrete | Discrete | Discrete Discrete | Discrete | Discrete Discrete Discrete 
Input6 Input 15 | Inputi4 Input13 | Inputi2 | Inputl1 Input10 Input 9 


16 Discrete | Discrete | Discrete Discrete | Discrete | Discrete Discrete Discrete 
Input8 Input7 Input6 Input5 Input4 Input3 Input2 Input1 
1 Discrete | Discrete | Discrete Discrete | Discrete | Discrete Discrete Discrete 
Input16 |Input15 | Inputl4 Input13 | Inputi2 | Inputl1 Input10 Input 9 
2 Discrete | Discrete | Discrete Discrete | Discrete | Discrete Discrete Discrete 
Input24 | Input23 | Input22 Input21 | Input20 | Inputl9 Input18 Input17 


17 Discrete | Discrete | Discrete Discrete | Discrete | Discrete Discrete Discrete 
Input8 Input7 Input6 Input5 Input4 Input3 Input2 Input1 
1 Discrete | Discrete | Discrete Discrete | Discrete | Discrete Discrete Discrete 
Input16 | Input 15 | Inputl4 Input13 | Inputi2 | Inputl1 Input10 Input 9 
2 Discrete | Discrete | Discrete Discrete | Discrete | Discrete Discrete Discrete 
Input24 |Input23 | Input22 Input21 | Input20 | Inputl9 Input18 Input17 
3} Discrete | Discrete | Discrete Discrete | Discrete | Discrete Discrete Discrete 
Input32 |Input31 |Input 30 | Input29 | Input28 | Input27 Input26 Input25 
Input8 Input7 Input6 InputS Input4 Input3 Input2 Input1 
Input16 | Input 15 | Inputl4 Input13 | Inputi2 | Inputl1 Input10 Input 9 
2 Discrete | Discrete | Discrete Discrete | Discrete | Discrete Discrete Discrete 
Input24 | Input23 | Input22 Input21 | Input20_ | Input19 Input18 Input17 
Input32 | Input31 [Input 30 | Input29 | Input28 | Input27 Input26 Input25 
Input40 | Input39 | Input38 Input37_ | Input 36 | Input35 Input34 Input33 
5 Discrete | Discrete | Discrete Discrete | Discrete | Discrete Discrete Discrete 
Input48 | Input47 | Input46 Input45 | Input44_ | Input43 Input42 Input41 
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Instance Bit 7 Bit 6 Bit 4 Bit 3 i Bit 1 Bit 0 


19 Discrete | Discrete Discrete | Discrete Discrete Discrete 
Input8 Input7 InputS Input4 Input2 Input1 


Discrete | Discrete | Discrete Discrete | Discrete | Discrete Discrete Discrete 
Input16 |Input 15 | Inputl4 Input13 | Inputi2 | Inputl1 Input10 Input 9 
Discrete | Discrete | Discrete Discrete | Discrete | Discrete Discrete Discrete 
Input24 | Input23 | Input22 Input21 | Input20_ | Inputl9 Input18 Input17 
Input32 | Input31 | Input30 Input29 | Input28 | Input27 Input26 Input25 
4 Discrete | Discrete | Discrete Discrete | Discrete | Discrete Discrete Discrete 
Input40_ | Input39 | Input38 Input37 | Input36 | Input35 Input34 Input33 


5 Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete Discrete 
Input48 | Input 47 | Input46 Input45 | Input 44 | Input43 Input42 Input41 
Input56 | Input55 | Input54 Input53 =| Input 52 | Input51 Input50 Input 49 
Input 64 | Input63 | Input62 Input61 |Input60 |Input59 | Input58 Input57 


Discrete | Discrete | Discrete Discrete | Discrete | Discrete Discrete 
Input8 Input7 Input6 InputS Input4 Input3 Input2 


Discrete 
Input1 


Discrete Discrete 
Input Input 
M M-1 


6-26.5.3 The I/O Assembly data attribute for Solenoids Status Data plus Discrete Input 
Data 


Table 6-26.11 I/O Assembly Data Attributes — Sol. Status & Discrete Input Data 

21 Reserved Discrete | Solenoid 
Input1 Status1 

DD. Reserved Discrete | Discrete | Solenoid | Solenoid 
Input2 Input1 Status2 | Status1 

23 Discrete | Discrete | Discrete | Discrete | Solenoid | Solenoid | Solenoid | Solenoid 
Input4 |Input3 | Input2 Input1 Status4 |Status3 | Status2 | Status 

24 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status8 |Status7 |Status6 |Status5 |Status4 |Status3 | Status2 Status1 

1 Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Input8 |Input7 | Input6 Input5 Input4 | Input3 Input2 Input1 


25 0 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status8 |Status7 |Status6 |Status5 |Status4 |Status3 | Status2 Status1 


1 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status16 | Status15 | Status14 | Status13 | Status12 | Status11 | Status10 | Status9 

2 Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Input8 |Input7 | Input6 Input5 Input4 | Input3 Input2 Input1 

3 Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Inputl6 | Input 15 | Inputi4 |Inputl3 |Inputl2 |Inputil |Inputl0 | Input 9 
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26 


27 


Pneumatic Valve Device, Type: 1Buex 

Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status8 |Status7 |Status6 |Status5 |Status4 |Status3 | Status2 Status1 
Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status16 | Status15 | Status14 | Status13 | Status12 | Status11 | Status10 | Status9 
Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status24 | Status23 | Status22 | Status21 | Status20 | Status19 | Status18 | Status17 
Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Input8 |Input7 | Input6 Input5 Input4 | Input3 Input2 Input1 
Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Input16 |Input15 |Inputi4 |Inputl3 |Inputl2 | Inputil |Input10 | Input9 
Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Input24 |Input23 |Input22 |Input21 |Input20 |Inputi9 |Input18 | Inputl7 
Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status8 |Status7 |Status6 |Status5 |Status4 |Status3 | Status2 Status1 
Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status16 | Status15 | Status14 | Status13 | Status12 | Status11 | Status10 | Status9 


Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status24 | Status23 | Status22 | Status21 | Status20 | Status19 | Status18 | Status17 


2 
3 


4 


2 


3 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status32 | Status31 | Status30 | Status29 | Status28 | Status27 | Status26 | Status25 


Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Input8 |Input7 | Input6 Input5 Input4 | Input3 Input2 Input1 

Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Inputl6 | Input 15 |Inputi4 |Inputl3 |Inputl2 |Inputil |Inputl0 | Input 9 

Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Input24 |Input23 |Input22 |Input21 |Input20 |Inputi9 |Inputl8 | Inputl7 
Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Input32 | Input31 | Input 30 |Input29 |Input28 | Input27 | Input26 | Input25 


4 


28 


0 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status8 |Status7 |Status6 |Status5 |Status4 |Status3 | Status2 Status1 


Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status16 | Status15 | Status14 | Status13 | Status12 | Status11 | Status10 | Status9 
Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status24 | Status23 | Status22 | Status21 | Status20 | Status19 | Status18 | Status17 


Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status32 | Status31 | Status30 | Status29 | Status28 | Status27 | Status26 | Status25 


Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status40 | Status39 | Status38 | Status37 | Status36 | Status35 | Status34 | Status33 


1 
5 
1 
IS) 
7 
5 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 

Status48 | Status47 | Status46 | Status45 | Status44 | Status43 | Status42 | Status41 
Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Input8 |Input7 | Input6 Input5 Input4 =| Input3 Input2 Input1 
Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Inputl6 | Input 15 | Inputi4 |Inputl3 |Inputl2 | Inputil |Inputl0 | Input 9 


Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Input24 |Input23 |Input22 |Input21 |Input20 |Inputi9 |Input18 | Inputl7 
Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Input32 |Input31 | Input30 |Input29 | Input28 | Input27 | Input26 | Input25 


7 
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Bit 0 
Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Input40 | Input39 | Input38 |Input37 | Input36 | Input35 | Input34 | Input33 
Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Input48 | Input 47 | Input46 |Input45 | Input 44 | Input43 | Input42 | Input41 


29 


0 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status8 |Status7 |Status6 |Status5 |Status4 | Status3 | Status2 Status1 


Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status16 | Status15 | Status14 | Status13 | Status12 | Status11 | Status10 | Status9 
Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status24 | Status23 | Status22 | Status21 | Status20 | Status19 | Status18 | Status17 


Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status32 | Status31 | Status30 | Status29 | Status28 | Status27 | Status26 | Status25 


i : 
: : 
4 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status40 | Status39 | Status38 | Status37 | Status36 | Status35 | Status34 | Status33 
IS) Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status48 | Status47 | Status46 | Status45 | Status44 | Status43 | Status42 | Status41 
Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status56 | Status55 | Status54 | Status53 | Status52 | Status51 | Status50 | Status49 
7 Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid | Solenoid 
Status64 | Status63 | Status62 | Status61 | Status60 | Status59 | Status58 | Status57 
Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Input8 |Input7 — | Input6 Input5 Input4 | Input3 Input2 Input 1 
Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Inputl6 |InputlS |Inputi4 |Inputl3 |Inputl2 | Inputil |Inputl0 | Input9 
10 Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Input24 |Input23 |Input22 | Input 21 | Input 20 | Inputi9 |Input18 | Inputl7 
11 Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Input32 |Input31 |Input30 |Input29 |Input28 | Input27 |Input26 | Input25 
12 Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Input40 | Input39 | Input38 |Input37 |Input36 | Input35 | Input34 = | Input33 
13 Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Input48 | Input 47 | Input46 |Input45 | Input 44 | Input43 | Input42 | Input41 
14 Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Input56 |Input55 |Input54 |Input53 | Input 52 | Input51 |Input50 | Input 49 
15 Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete | Discrete 
Input 64 | Input63 | Input62 |Input61 |Input60 | Input 59 | Input58 | Input57 
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6-26.5.4 The I/O Assembly data attribute for the Solenoid Valves Output Data 
Table 6-26.12 I/O Assembly Data Attributes — Solenoid Valves Output Data 


31 Reserved Solenoid 
Output1 


32 Reserved Solenoid | Solenoid 
Output2 Output1 

33 Reserved Solenoid |Solenoid | Solenoid | Solenoid 
Output4 Output3 Output2 Output1 

34 Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid | Solenoid 
Output8 Output7 Output6 OutputS Output4 Output3 Output2 Output1 


35 Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid | Solenoid 
Output8 Output7 Output6 OutputS Output4 Output3 Output2 Output1 

1 Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid {Solenoid | Solenoid 
Output16 |OutputlS | Outputl4 | Outputl3 | Outputl2 | Outputl1 | OutputlO | Output9 


36 0 Solenoid |Solenoid | Solenoid |Solenoid |Solenoid |Solenoid | Solenoid | Solenoid 
Output8 Output7 Output6 OutputS Output4 Output3 Output2 Output1 


1 Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid | Solenoid 
Output16 |OutputlS | Outputl4 | Outputi3 | Outputl2 | Outputl1 | OutputlO | Output9 


2 Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid | Solenoid 
Output24 | Output23 | Output22 | Output21 | Output20 | Outputl9 | Outputl8 | Outputl7 
Solenoid 


37 Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid | Solenoid 

Output8 Output7 Output6 OutputS Output4 Output3 Output2 Output1 

1 Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid | Solenoid 
Output16 |OutputlS | Outputl4 | Outputl3 | Outputl2 | Outputl1 | OutputlO | Output9 

2 Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid | Solenoid 
Output24 | Output23 | Output22 | Output21 | Output20 | Outputl9 | Outputl8 | Outputl7 

3 Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid | Solenoid 
Output32 | Output31 | Output30 | Output29 | Output28 | Output27 | Output26 | Output25 


38 Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid | Solenoid 
Output8 Output7 Output6 OutputS Output4 Output3 Output2 Output1 

1 Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid | Solenoid 
Output16 |OutputlS | Outputl4 | Outputi3 | Outputl2 | Outputl1 | OutputlO | Output9 

2 Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid | Solenoid 

Output24 | Output23 | Output22 | Output21 | Output20 | Outputl9 | Outputl8 | Outputl7 

3 Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid | Solenoid 

Output32 | Output31 | Output30 | Output29 | Output28 | Output27 | Output26 | Output25 

4 Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid | Solenoid 

Output40 | Output39 | Output38 | Output37 | Output36 | Output35 | Output34 | Output33 

5) Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid | Solenoid 

Output48 | Output47 | Output46 | Output45 | Output44 | Output43 | Output42 | Output41 
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39 Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid | Solenoid 
Output8 Output7 Output6 OutputS Output4 Output3 Output2 Output1 
1 Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid | Solenoid | Solenoid 
Output16 |OutputlS | Outputl4 | Outputl3 | Outputl2 | Outputl1 | OutputlO | Output9 
2 Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid | Solenoid 
Output24 | Output23 | Output22 | Output21 | Output20 | Outputl9 | Outputl8 | Outputl7 
3 Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid | Solenoid 
Output32 | Output31 | Output30 | Output29 | Output28 | Output27 | Output26 | Output25 
4 Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid | Solenoid 
Output40 | Output39 | Output38 | Output37 | Output36 | Output35 | Output34 | Output33 
5 Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid | Solenoid 
Output48 | Output47 | Output46 | Output45 | Output44 | Output43 | Output42 | Output41 
Solenoid |Solenoid |Solenoid |Solenoid | Solenoid |Solenoid |Solenoid | Solenoid 
Output56 | Output55 | Output54 | Output53 | Output52 | Output51 | Output50 | Output49 
7 Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid |Solenoid | Solenoid 
Output64 | Output63 | Output62 | Output61 | Output60 | Output59 | Output58 | OutputS7 


Solenoid |Solenoid |Solenoid | Solenoid | Solenoid Solenoid | Solenoid | Solenoid 
Output8 Output7 Output6 OutputS Output4 Output3 | Output2 | Outputl 


Mapping I/O Assembly Data Attribute Components 


The following table indicates the I/O assembly Data attribute mapping for the Pneumatic Valve 
Manifold device for the input assemblies numbered 1 through 10. These assemblies only 
present Solenoid Status information. The exact meaning of a “Solenoid Status” point is 
defined and assigned in the vendor instruction manual. Unless otherwise specified, the value 
1=TRUE="Energized Solenoid” is assumed in each assembly. Likewise, the value 
0=FALSE=”De-energized Solenoid” is assumed in each assembly unless otherwise specified. 


Table 6-26.13 I/O Assembly Data Mapping — Input Assemblies 1-10 
Number 


Discrete Input | O8pox L Value 
Point 


The following table indicates the I/O assembly Data attribute mapping for Pneumatic Valve 
Manifold device for the input assemblies numbered 11 through 20. These assemblies only 
present values from General Purpose Discrete Input points. These points are not explicitly 
associated with Solenoid Value status (as defined in assemblies 1 through 10). Rather, the 
exact meaning of each point shall be defined and assigned by the vendor instruction manual. 


Data Component 


Name Number 


Solenoid Status L 
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Table 6-26.14 I/O Assembly Data Mapping — Input Assemblies 11-20 
Data Component Instance Attribute 


Name | Name | | Number | Number | Name | Number 


Discrete Input M ese Input ——- ee 
Point 


The following table indicates the I/O assembly Data attribute mapping for the Pneumatic 
Valve Manifold device for the input assemblies numbered 21 through 29. These assemblies 
present both Solenoid Status information as well as General Purpose Discrete Input point 
values. The exact meaning of a “Solenoid Status” point is defined and assigned in the vendor 
instruction manual. Unless otherwise specified, the value 1=TRUE=”Energized Solenoid” is 
assumed in each assembly. Likewise, the value O=FALSE=”De-energized Solenoid” is 
assumed in each assembly unless otherwise specified. The Discrete Input point values are not 
explicitly associated with Solenoid Value status. The exact meaning of each point shall be 
defined and assigned by the vendor instruction manual. 


Table 6-26.15 I/O Assembly Data Mapping — Input Assemblies 21-29 


Data Component Instance Attribute 
Name Number Number 
Solenoid Status L | Discrete Input | 08,6, L Value 3 
Point 
Discrete Input M | Discrete Input | O8p,, M Value 3 
Point 


The following table indicates the I/O assembly Data attribute mapping for Pneumatic Valve 
Manifold device for the Solenoid output assemblies. 


Table 6-26.16 I/O Assembly Data Mapping — Solenoid Output Assemblies 


Discrete Input O8hex N Value 
Point 


Important: If I/O Assembly instances 10 or 20 are supported, the “Max Instance” attribute at 
the class level of the Discrete Input Point class must be supported. If I/O Assembly instance 40 
is supported, the “Max Instance” attribute at the class level of the Discrete Output Point class 
must be supported. 


Data Component 


Number 


Solenoid Output L 


Configuration Data and Public Interfaces 
Device configuration data and its public interfaces are vendor specific. 
Parameter Object Instances 


The Parameter Object Class, its instances and data mapping are optional and vendor specific. 
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6-27 Contactor Device 


Device Type: 15 hex 

The Contactor device profile is part of a “Hierarchy of Motor Control Devices” that are 
supported by CIP. This hierarchy includes: 

e Contactors, Overloads, and Across the Line Motor Starters 

e Softstarters 

e AC/DC Drives 

e Servo Drives 

Devices within this hierarchy use a common Control Supervisor object to control state behavior 
of the device. Devices within this hierarchy also support a hierarchy of “IO Assembly 
Instance” definitions which are used to pass control and status information to and from a 
device. Assembly instances are numbered so that each device type is assigned a range of 
instance numbers, with higher functionality devices supporting higher instance numbers. 
Devices within the hierarchy can choose to support some instance numbers that are lower than 
theirs in the hierarchy. For example, an AC Drive may choose to support some instances that 
are defined for Across the Line Motor Starters. This makes it easier to interchange drives and 
starters within a system. 


This profile makes Motor Starters of the same device type inter-operable, but not directly 
interchangeable without doing configuration through a unit’s local interface, a network 
configuration tool or other means of configuring outside the CIP interface. 


6-27.1 Object Model 


The Object Model in Figure 6-27.2 represents a Contactor. The table below indicates: 
e the object classes present in this device 

e whether or not the class is required 

e the number of instances present in each class 


Table 6-27.1 Objects Present in a Contactor Device 


Object Class # of Instances 
Message Router - 
CIP Common Required Objects See Section 6-2.1 
Parameter - 
Control Supervisor 1 
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Figure 6-27.2 Object Model for a Contactor Device 


Parameter 


Network 
Specific Link 
Object(s) 


Message 
Router 


Assembly 


Input Output 
Instance Instance 


Cc) Required © ) Optional 


Connection Manager o 
1/O Data Connection Object a) 


CIP Network 


6-27.2 How Objects Affect Behavior 
The objects for this device affect the device’s behavior as shown in the table below. 


Table 6-27.3 Object Effect On Behavior 


Object Effect on behavior 
CIP Common Required _| See Section 6-2.2 for details. 
Assembly Defines I/O data format 
Parameter Provides a public interface to device configuration data 
Control Supervisor Manages motor functions and operational states 


6-27.3 Defining Object Interfaces 
The objects in the Contactor Device have the interfaces listed in the following table: 


Table 6-27.4 Object Interfaces 


Object Interface 
CIP Common Required | See Section 6-2.3 for details. 
Assembly 1/O Connection or Message Router 
Parameter Message Router 
Control Supervisor Message Router, Assembly or Parameter Object 
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6-27.4 Contactor Interface and Behavior 
Figure 6-27.5 Object Interfaces and Effect on Behavior 
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6-27.5 I/O Assembly Instance 


The IO Assembly Instance definitions in this section define the format of the “data” attribute 
(attribute 3) for IO Assembly Instances. Through the use of predefined instance definitions, IO 
Assemblies support a hierarchy of motor control devices. The device hierarchy includes motor 
starters, soft starters, AC and DC drives, and servo drives. Assembly Instances are numbered 
within the hierarchy so that each device type is assigned a range of Assembly Instance 
numbers, with higher functionality devices supporting higher instance numbers. Devices in the 
hierarchy can choose to support instance numbers that are lower than theirs in the 
hierarchy. For example a Softstart may choose to support some IO Assemblies that are 
defined for Overload. The following table shows the Assembly Instance numbering for the 
motor control device hierarchy. 


Table 6-27.6 I/O Assembly Instances — Motor Control Device 


Profile 1/O Type Instance 
Range 


Contactors, Overloads and 1-19 

Starters 50-69 
AC/DC Drive 20-29 
Servo Drive 30-49 


The following IO Assembly Instances are defined for Contactors. 


Table 6-27.7 I/O Assembly Instances — Contactor Device 


Instance Type Name 
1 Output Basic Contactor 
4 Output Extended Contactor 


If a bit is not used in an IO Assembly, it is reserved for use in other Assemblies. Reserved bits 
in Output Assemblies are ignored by the consuming device. Reserved bits in Input Assemblies 
are set to zero by the producing device. 


6-27.5.1 | Connection Paths to I/O Assembly Instances 
The IO Assembly Instances are chosen for IO Connections by setting the 
“produced_connection_path” (attribute 14) and “consumed_connection_path” (attribute 16) 
attributes in the appropriate connection object. 
Motor Control Devices use the Symbolic Segment Type (see Appendix C) to specify paths to 
the IO Assembly Instances in the Motor Control Hierarchy. IO Assembly Instances are 
represented by ASCII strings that contain the hex number of the Assembly Instance whose path 
is to be chosen. 
The following example shows the Symbolic Segment used to specify Output Assembly 
Instance 20 (14 hex). 


Figure 6-27.8 Symbolic Segment Example 


Segment Type First Character Second Character 
01 1/0 00 1 0 0011000 41 0011010 0 


Segment Symbol size in ASCII 1 (31 hex) ASCII 4 (34 hex) 
type bytes (2 bytes) 
(symbolic) 
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6-27.6 I/O Assembly Data Attribute Format 


Table 6-27.9 I/O Assembly Data Attribute Format — Instance 1, Basic Contactor 


Instance 1: Basic Contactor 
This is the only required output assembly for device types Motor Contactor (0x15hex) and Softstart 


(0x15hex). 
Byte Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
0 Reserved | Reserved Reserved Reserved Reserved Reserved | Reserved | Runl 


Table 6-27.10 I/O Assembly Data Attribute Format — Instance 4, Ext. Contactor 


Instance 4: Extended Contactor (see table for functional assignments) 
This assembly uses some optional attributes.. 


Byte Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
0 Reserved | Reserved Reserved Reserved Reserved Reserved | Run2 Runi 


6-27.7. Mapping I/O Assembly Data Attribute Components 


The following table indicates the I/O Assembly Data Attribute mapping for Contactor Output 
Assemblies. 


Table 6-27.11 I/O Assembly Data Attribute Mapping 


Class Attribute Attribute 
Data N. Class N. Inst 
ata Name ass Name Niniher nstance Name Nilinber 


Run1 Control SEE! Ox 29 Run1 


6-27.8 Defining Device Configuration 


Public access to the Control Supervisor Object must be supported for configuration of 
Contactor devices. If supported, optional Parameter Objects may be used to access the various 
configuration attributes in the Control Supervisor Object. 
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6-28 Motor Starter Device 


Device Type: 16 hex 

The Motor Starter device profile is part of a “Hierarchy of Motor Control Devices” that are 
supported by CIP. This hierarchy includes: 

e Contactors, Overloads, and Across the Line Motor Starters 

e Softstarters 

e AC/DC Drives 

e Servo Drives 

Devices within this hierarchy use a common Control Supervisor object to control state behavior 
of the device. Devices within this hierarchy also support a hierarchy of “IO Assembly 
Instance” definitions which are used to pass control and status information to and from a 
device. Assembly instances are numbered so that each device type is assigned a range of 
instance numbers, with higher functionality devices supporting higher instance numbers. 
Devices within the hierarchy can choose to support some instance numbers that are lower than 
theirs in the hierarchy. For example, an AC Drive may choose to support some instances that 
are defined for Across the Line Motor Starters. This makes it easier to interchange drives and 
starters within a system. 

This profile makes Motor Starters of the same device type inter-operable, but not directly 
interchangeable without doing configuration through a unit’s local interface, a network 
configuration tool or other means of configuring outside the CIP interface. 


6-28.1 Object Model 
The Object Model in Figure 6-28.2 represents a Motor Starter. The table below indicates: 


e the object classes present in this device 
e whether or not the class is required 
e the number of instances present in each class 


Figure 6-28.1 Objects Present in a Motor Starter Device 


Object Class # of Instances 
Message Router 1 
CIP Common Required Objects See Section 6-2.1 
Parameter - 
Control Supervisor 1 
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Figure 6-28.2 Object Model for Motor Starter Device 
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6-28.2 How Objects Affect Behavior 


The objects for this device affect the device’s behavior as shown in the table below. 


Figure 6-28.3 Object Effect On Behavior 


Object Effect on behavior 
CIP Common Required | See Section 6-2.2 for details. 
Assembly Defines I/O data format 
Parameter Provides a public interface to device configuration data 
Control Supervisor Manages motor functions and operational states 
Overload Implements overload 


6-28.3 Defining Object Interfaces 


The objects in the Motor Overload have the interfaces listed in the following table: 


Figure 6-28.4 Object Interfaces 


Object Interface 
CIP Common Required | See Section 6-2.3 for details. 
Assembly I/O Connection or Message Router 
Parameter Message Router 
Control Supervisor Message Router, Assembly or Parameter Object 
Overload Message Router, Assembly or Parameter Object 
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6-28.3.1 Starter Interface and Behavior 
Figure 6-28.5 Starter Interface & Behavior Diagram 
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6-28.3.2. Reversing Motor Starter Interface and Behavior 


Figure 6-28.6 Reversing Motor Starter Interface & Behavior Diagram 
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6-28.3.3 Two Speed Motor Starter Interface and Behavior 


Figure 6-28.7 Two Speed Motor Starter Interface & Behavior Diagram 
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6-28.4 I/O Assembly Instances 


The IO Assembly Instance definitions in this section define the format of the “data” attribute 
(attribute 3) for IO Assembly Instances. Through the use of predefined instance definitions, IO 
Assemblies support a hierarchy of motor control devices. The device hierarchy includes motor 
starters, soft starters, AC and DC drives, and servo drives. Assembly Instances are numbered 
within the hierarchy so that each device type is assigned a range of Assembly Instance 
numbers, with higher functionality devices supporting higher instance numbers. Devices in the 
hierarchy can choose to support instance numbers that are lower than theirs in the 
hierarchy. For example a Softstart may choose to support some IO Assemblies that are 
defined for Overload. The following table shows the Assembly Instance numbering for the 
motor control device hierarchy. 


Table 6-28.8 Assembly Instance Numbering for Motor Control Device Hierarchy 


Profile 1/O Type Instance Range 

1-19 

Contactors, Overloads and Starters 
50-69 
20-29 

AC/DC Drive 
70-79 
30-49 

Servo Drive 
80-99 


The following IO Assembly Instances are defined for Motor Starters. 


Table 6-28.9 Assembly Instances for Motor Starters 


Instance Type Name 
3 Output Basic Motor Starter 
4 Output Extended Contactor 
5 Output Extended Motor Starter 
52 Input Basic Motor Starter 
53 Input Extended Motor Starter 1 
54 Input Extended Motor Starter 2 


If a bit is not used in an IO Assembly, it is reserved for use in other Assemblies. Reserved bits 
in Output Assemblies are ignored by the consuming device. Reserved bits in Input Assemblies 
are set to zero by the producing device. 


6-28.4.1 | Connection Paths to I/O Assembly Instances 
The IO Assembly Instances are chosen for IO Connections by setting the 
“produced_connection_path” (attribute 14) and “consumed_connection_path” (attribute 16) 
attributes in the appropriate connection object. 
Motor Control Devices use the Symbolic Segment Type (see Appendix C) to specify paths to 
the IO Assembly Instances in the Motor Control Hierarchy. IO Assembly Instances are 
represented by ASCII strings that contain the hex number of the Assembly Instance whose path 
is to be chosen. 
The following example shows the Symbolic Segment used to specify Output Assembly 
Instance 20 (14 hex). 
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Figure 6-28.10 Symbolic Segment Example 


Segment Type First Character Second Character 
0 11/0 00 1 0 001100041 0011010 0 
Segment Symbol size in ASCII 1 (31 hex) ASCII 4 (34 hex) 
type bytes (2 bytes) 
(symbolic) 


6-28.5 I/O Assembly Data Attribute Format 
6-28.5.1 | Output Assembly Data Attribute Format 


Table 6-28.11 Instance 3: Basic Motor Starter 


This is the only required output assembly for device type Motor Starter (16hex) 
Byte Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 


0 Reserved | Reserved | Reserved | Reserved | Reserved | FaultReset | Reserved | Run1 


Table 6-28.12 Instance 4: Extended Contactor (see table for functional assignments) 


This assembly uses some optional attributes. 


Byte Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
0 Reserved | Reserved | Reserved | Reserved | Reserved | Reserved | Run2 Runli 


Table 6-28.13 Instance 5: Extended Motor Starter (see table for functional assignments) 


This assembly uses some optional attributes.. 


Byte Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
0 Reserved | Reserved | Reserved | Reserved | Reserved | FaultReset | Run2 Runi 


6-28.5.2. Input Assembly Data Attribute Format 


Table 6-28.14 Instance 52: Basic Motor Starter 


This is the only required input assembly for Motor Starter (16hex) 


Reserved 


Trip 


Table 6-28.15 Instance 53: Extended Motor Starter 1 (see table for functional assignments) 


This assembly uses some optional attributes 


Byte Bit 7 Bit 6 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
0 Reserved | Reserved | Cntrlfrom | Ready Reserved | Running! | Warning | Faulted/ 
Trip 


Table 6-28.16 Instance 54: Extended Motor Starter 2 (see table for functional assignments) 


This assembly uses some optional attributes 
Byte Bit 7 Bit 6 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
0 Reserved | Reserved | Cntrlfrom | Ready Running2 | Running! | Warning | Faulted/ 
Trip 
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Mapping I/O Assembly Data Attribute Components 


Mapping for Motor Starter Output Assembly Data Components 
Table 6-28.17 Output Data Assembly Mapping 


Data Class Name Class Number | Instance | Attribute Name | Attribute Number 
Name 
Run1 Control Supervisor 0x29 1 3 


Mapping for Motor Starter Input Assembly Data Components 
Table 6-28.18 Input Data Assembly Mapping 


Data Class Name Class Number | Instance | Attribute Name | Attribute Number 
Name 
Faulted/ Control Supervisor 0x29 1 Faulted 10 
Trip 
Warning 11 
Running1 7 
Running2 8 
Ready 9 
Control 15 
From Net 


Defining Device Configuration 


Public access to the Control Supervisor Object and the Overload Object must be supported for 
configuration of Motor Starter devices. If supported, optional Parameter Objects may be used 


to access the various configuration attributes in the Control Supervisor Object and the Overload 
Object. 
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6-29 Softstart Starter Device 


Device Type: 17 hex 

The Softstart Starter device profile is part of a “Hierarchy of Motor Control Devices” that are 
supported by CIP. This hierarchy includes: 

e Contactors, Overloads, and Across the Line Motor Starters 

e §6Softstarters 

AC/DC Drives 

e Servo Drives 


Devices within this hierarchy use a common Control Supervisor object to control state behavior 
of the device. Devices within this hierarchy also support a hierarchy of “IO Assembly 
Instance” definitions which are used to pass control and status information to and from a 
device. Assembly instances are numbered so that each device type is assigned a range of 
instance numbers, with higher functionality devices supporting higher instance numbers. 
Devices within the hierarchy can choose to support some instance numbers that are lower than 
theirs in the hierarchy. For example, an AC Drive may choose to support some instances that 
are defined for Across the Line Motor Starters. This makes it easier to interchange drives and 
starters within a system. 


This profile makes Softstart Starters of the same device type inter-operable, but not directly 
interchangeable without doing configuration through a unit’s local interface, a network 
configuration tool or other means of configuring outside the CIP interface. 


6-29.1 Object Model 


The Object Model in Figure 6-29.2 represents a Softstart Starter. The table below indicates: 


e the object classes present in this device 
e whether or not the class is required 
e the number of instances present in each class 


Table 6-29.1 Object Classes Present in a Softstart Starter Device 


Object Class Optional/Required # of Instances 
Message Router Optional 1 
CIP Common Required Objects See Section 6-2.1 
Parameter - 
Control Supervisor i 
Softstart - 
Motor Data - 
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Figure 6-29.2 Object Model for Softstart Starter Device 
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6-29.2 How Objects Affect Behavior 
The objects for this device affect the device’s behavior as shown in the table below. 


Table 6-29.3 Object Effect on Behavior 


CIP Network 


Object Effect on behavior 
CIP Common Required | See Section 6-2.2 for details. 
Assembly Defines I/O data format 
Parameter Provides a public interface to device configuration data 
Control Supervisor Manages motor functions and operational states 
Softstart Implements the Softstart 
functions 
Overload Implements overload 
Motor Data Define motor data for motor connected to this device. 
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6-29.3 Defining Object Interfaces 


The objects in the Motor Overload have the interfaces listed in the following table: 


Table 6-29.4 Object Interfaces 


Object Interface 
CIP Common Required | See Section 6-2.3 for details. 
Assembly I/O Connection or Message Router 
Parameter Message Router 
Control Supervisor Message Router, Assembly or Parameter Object 
Softstart Message Router or Assembly 
Overload Message Router, Assembly or Parameter Object 
Motor Data Message Router, Parameter Object 
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6-29.4 Softstart Motor Interface and Behavior 
Figure 6-29.5 Softstart Motor Interface & Behavior Diagram 
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6-29.5 I/O Assembly Instances 


The IO Assembly Instance definitions in this section define the format of the “data” attribute 
(attribute 3) for IO Assembly Instances. Through the use of predefined instance definitions, IO 
Assemblies support a hierarchy of motor control devices. The device hierarchy includes motor 
starters, soft starters, AC and DC drives, and servo drives. Assembly Instances are numbered 
within the hierarchy so that each device type is assigned a range of Assembly Instance 
numbers, with higher functionality devices supporting higher instance numbers. Devices in the 
hierarchy can choose to support instance numbers that are lower than theirs in the 
hierarchy. For example a Softstart may choose to support some IO Assemblies that are 
defined for Overload. The following table shows the Assembly Instance numbering for the 
motor control device hierarchy. 


Table 6-29.6 I/O Assembly Instance Numbering Ranges 


Profile 1/O Type Instance 
Range 


Contactors, Overloads and 1-19 

Starters 50-69 
AC/DC Drive 20-29 
Servo Drive 30-49 


The following IO Assembly Instances are defined for Softstarters. 


Table 6-29.7 I/O Assembly Instances for Softstarters 


Instance Type Name 
60 Input Basic Softstart 
61 Input Extended Softstart 


6-29.5.1 | Connection Paths to I/O Assembly Instances 


The IO Assembly Instances are chosen for IO Connections by setting the 
“produced_connection_path” (attribute 14) and “consumed_connection_path” (attribute 16) 
attributes in the appropriate connection object. 


Motor Control Devices use the Symbolic Segment Type (see Appendix C) to specify paths to 
the IO Assembly Instances in the Motor Control Hierarchy. IO Assembly Instances are 
represented by ASCII strings that contain the hex number of the Assembly Instance whose path 
is to be chosen. 


The following example shows the Symbolic Segment used to specify Output Assembly 
Instance 20 (14 hex). 


Table 6-29.8 Symbolic Segment Example 


Segment Type First Character Second Character 
0 11/0 00 1 0 001100041 001101 0 0 
Segment Symbol size in ASCII 1 (31 hex) ASCII 4 (34 hex) 
type bytes (2 bytes) 
(symbolic) 
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I/O Assembly Data Attribute Format 


Output Assembly Data Attribute Format 
There are no new output assemblies defined for Softstart devices. 


Input Assembly Data Attribute Format 


Table 6-29.9 Instance 60: Basic Softstart Input 


This is the only required input assembly. for the device type SoftStart (15hex) 


Byte Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
0 At Reserved | Reserved Reserved | Reserved | Running1 | Reserved | Faulted/ 
Reference Trip 


Table 6-29.10 Instance 61: Extended Softstart Input (see table for functional assignments) 


This assembly uses some of the optional attributes. 


Byte Bit 7 Bit 6 Bit 0 
0 At Reserved | CntrlfromNet Faulted/ 
Reference Trip 


Mapping I/O Assembly Data Attribute Components 
Table 6-29.11 Assembly Data Attribute Mapping 


Data Name Class Name Class Instance | Attribute Attribute 
Number Name Number 
Faulted/ Trip Control Supervisor 0x29 Faulted/ Trip 10 


1 
Control From Net 15 


At Reference 


Defining Device Configuration 


Public access to the Control Supervisor Object and the Overload Object must be supported for 
configuration of Softstart devices. If supported, optional Parameter Objects may be used to 
access the various configuration attributes in the Control Supervisor Object and the Overload 
Object. 
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6-30 Human-Machine Interface (HMI) 


Device Type: 18 hex 


The Human-Machine Interface (HMI) Device type is based on the Generic Device Type 
(OOhex). The purpose of this device profile is to allow network tools to identify and distinguish 
HMI devices from other Generic devices on a network. Over time, the and ControlNet 
International and Open DeviceNet Vendor Association’s HMI Special Interest Groups (SIG) 
will enhance the HMI device profile to define minimum required objects and optional objects 
which are similar among HMI devices. HMI Device type devices are not interchangeable. 


6-30.1 Object Model 


The Object Model in Figure 6-30.2 represents the minimum support in an HMI Device. The 
table below indicates: 

e the object classes present in this device 

e whether or not the class is required 

e the number of instances present in each class 


Table 6-30.1 Objects Present in an HMI Device 


Object Class # of Instances 
CIP Common Required Objects See Section 6-2.1 
Assembly at least 1 
Application at least 1 


The HMI Device profile cannot specify the definition of the Assembly Object or the type of 
application objects necessary for device operation. This portion of the device profile must be 
supplied by the product developer as described in Section 6-1 through 6-7 inclusive. 


Figure 6-30.2 Object Model for an HMI Device 
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How Objects Affect Behavior 


The objects for this device affect the device’s behavior as shown in the table below. 


Table 6-30.3 Object Effect on Behavior 


Object Effect on behavior 
CIP Common Required See Section 6-2.2 for details. 
Assembly Defines input/output and configuration data format 
Application Defines device operation 


Defining Object Interfaces 


The objects in the HMI Device have the interfaces listed in the following table: 
Table 6-30.4 Object Interfaces 


Object Interface 
CIP Common Required See Section 6-2.3 for details. 
Assembly I/O Connection or Message Router 
Application Assembly or Message Router 
— 6-150 - 
Edition 3.3 


ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 6: Device Profiles, Part 3 


Mass Flow Controller Device, Type: 1Anex 


6-31 Mass Flow Controller Device 


Device Type: 1A hex 

A Mass Flow Controller is a device that measures and controls the mass flow rate of gas or 
liquid. It contains three principle components: a mass flow rate sensor which can be one of a 
variety of types, including thermal or pressure-based; a mass flow rate metering valve which 
can be actuated by one of a variety of actuator types, including solenoid, voice coil or piezo; 
and, a controller which closes the loop by receiving a setpoint and driving the actuator such that 
the mass flow rate is controlled to the setpoint. 


6-31.1 Object Model 


The Object Model in Figure 6-31.4 represents a Mass Flow Controller Device. The table below 
indicates: 

e the object classes present in this device 

e whether or not the class is required 

e the number of instances present in each class 


Table 6-31.1 Objects Present in a Mass Flow Controller Device 


Object Class Optional/Required # of Instances 
CIP Common Required Objects | Required See Section 6-2.1 
Assembly Required at least 1 Input and 1 Output 
S-Device Supervisor Required 
S-Gas Calibration Optional 0 or More 


BR 


S-Analog Sensor Required 


a 


S-Analog Actuator Conditional * 


a 


BR 


S-Single Stage Controller Conditional * 


* Required for a Mass Flow Controller, a device that contains a Valve and a Controller. 
Not supported in a Mass Flow Meter Device (an MFC without a Valve or a Controller). 


6-31.1.1 Class Subclasses 


Each class level subclass defines a unique meaning for an overlapping range of class attribute 
IDs and/or class service IDs. The range for subclass definitions begins at ID 96 and numbers 
downward for attributes, and ID 63;., and numbers downward for services. The subclass for a 
given class is identified by the value of its Subclass class attribute. There are no class level 
subclasses specified for this device. 


6-31.1.2 Instance Subclasses 


Each instance level subclass defines a unique meaning for an overlapping range of instance 
attribute IDs and/or instance service IDs. The range for subclass definitions begins at ID 96 
and numbers downward for attributes, and ID 63)... and numbers downward for services. The 
subclass for a given instance is identified by the value of its Subclass instance attribute. The 
following tables identify which object instance IDs are assigned subclasses for this device. 


Table 6-31.2 S-Analog Sensor Object Subclasses 


Instance Subclass Name Subclass ID | Required Function Restrictions 
ID (Attribute 
99 Value) 
1 Flow Diagnostics 01 Required Added diagnostics | None 
for MFC 
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Table 6-31.3 S-Gas Calibration Object Subclasses 


Instance Subclass Name Subclass ID | Required Function Restrictions 
ID (Attribute 
99 Value) 
1 Standard T & P 01 Optional Standard None 
Temperature and 
Pressure 


Figure 6-31.4 Object Model for the MFC Device 
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6-31.2 How Objects Affect Behavior 
Table 6-31.5 Object Affect on Behavior 


Object Effect on behavior 
CIP Common Required See Section 6-2.2 for details. 
Assembly Defines input/output and configuration data format 
S-Device Supervisor Supports the Stop, Start, Reset, Abort, Recover and Perform_Diagnostic services for 


ALL Application Objects in the device and consolidates the Exception Conditions 
and Application Objects’ Status. 


This object behaves differently from the Identity Object in that the S-Device 
Supervisor object provides a single point of access to the Application Objects only; it 
does not effect the CIP specific objects (i.e., Identity, Network Specific Link Object, 
Connection, etc.). 


S-Gas Calibration Modifies the correction algorithm of the S-Analog Sensor object which includes the 
selection mechanism to enable an S-Gas Calibration object instance. 


S-Analog Sensor Feeds the process variable to the Single Stage Controller object 
S-Single Stage Controller | Feeds the control variable to the Analog Actuator object 
S-Analog Actuator Operates the Flow Control Valve of the device 
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6-31.3 Defining Object Interfaces 
Table 6-31.6 Object Interfaces 


Object Interface 
CIP Common Required See Section 6-2.3 for details. 
Assembly 1/O Connection or Message Router 
S-Device Supervisor Assembly or Message Router 
S-Gas Calibration Message Router 
S-Analog Sensor Assembly or Message Router 


S-Single Stage Controller | Assembly or Message Router 
S-Analog Actuator Assembly or Message Router 


— 6-153 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 6: Device Profiles, Part 3 


6-31.4 


Mass Flow Controller Device, Type: 1Apex 


I/O Assembly Instances 
The following table identifies the I/O assembly instances supported by the MFC. 
Table 6-31.7 I/O Assembly Instances 


Number Name 

Status and Flow 

Status, Flow and Valve 

Status, Flow, and Setpoint 

Status, Flow, Setpoint and Valve 

Status, Flow, Setpoint, Override and Valve 
Override and Setpoint 

[Nf Input Exception Detail Alarm 

[Nf Input Exception Detail Warning 

12 IN Input Exception Detail Alarm and Exception Detail Warning 
14 fy sf Input. =| FP-Status and Flow 

15 [Nf Input FP-Status, Flow and Valve 

16 [Nf Input FP-Status, Flow, and Setpoint 

17 [Nf Input FP-Status, Flow, Setpoint and Valve 

18 Ly Input FP-Status, Flow, Setpoint, Override and Valve 
19 LY sf Output FP-Setpoint 

20 LY = fOutput FP-Override and Setpoint 


OlSMOIN| DA] OP R]_ wl) nNnir 


Pie 
Plo 
ZI\AZAl\KIAZAl/A42i\ 242/242), 24 
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6-31.5 I/O Assembly Object Instance Data Attribute Format 


The manufacturer of a Mass Flow Controller Device must specify which Assembly instances 
are supported by the device. 


The I/O Assembly DATA attribute has the format shown below. 
Table 6-31.8 I/O Assembly Data Attribute Format 


1 | 0 | Flow (low byte) 
Flow (high byte) 

2 Ex Status 
Flow (low byte) 
Flow (high byte) 

3 | 0 | Status 
Flow (low byte) 
Flow (high byte) 
Valve (low byte) 
Valve (high byte) 

4 | 0 | Status 
Flow (low byte) 
Flow (high byte) 
Setpoint (low byte) 
Setpoint (high byte) 

5 | 0 | Status 
Flow (low byte) 
Flow (high byte) 
Setpoint (low byte) 
Setpoint (high byte) 
Valve (low byte) 
| 6 | Valve (high byte) 

6 Em Status 
Flow (low byte) 
Flow (high byte) 
Setpoint (low byte) 
Setpoint (high byte) 
Override 
Ea Valve (low byte) 
Valve (high byte) 

7 | 0 | Setpoint (low byte) 
Setpoint (high byte) 

8 | Oo | Override 
Setpoint (low byte) 
Setpoint (high byte) 
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9 | 0 | Status 

10 | Oo | Status 
Exception Detail Alarm 0 (size, common) 
Exception Detail Alarm 1 (common 0) 
Exception Detail Alarm 2 (common 1) 
Exception Detail Alarm 3 (size, device) 
Exception Detail Alarm 4 (device 0) 
| 6 | Exception Detail Alarm 5 (size, manufacturer) 
Exception Detail Alarm 6 (manufacturer 0) 

11 | 0 | Status 
Exception Detail Warning 0 (size, common) 
Exception Detail Warning 1 (common 0) 
Exception Detail Warning 2 (common 1) 
Exception Detail Warning 3 (size, device) 
Exception Detail Warning 4 (device 0) 
| 6 | Exception Detail Warning 5 (size, manufacturer) 
Exception Detail Warning 6 (manufacturer, 0) 

12 | 0 | Status 
Exception Detail Alarm 0 (size, common) 
Exception Detail Alarm 1 (common 0) 
Exception Detail Alarm 2 (common 1) 
Exception Detail Alarm 3 (size, device) 
Exception Detail Alarm 4 (device 0) 
8 Exception Detail Alarm 5 (size, manufacturer) 
Exception Detail Alarm 6 (manufacturer, 0) 
| 8 | Exception Detail Warning 0 (size, common) 
Esa Exception Detail Warning 1 (common 0) 
Exception Detail Warning 2 (common 1) 
Exception Detail Warning 3 (size, device) 
Exception Detail Warning 4 (device 0) 
Exception Detail Warning 5 (size, manufacturer) 
Exception Detail Warning 6 (manufacturer, 0) 


13 ra Flow (low byte) 
Flow 
Flow 
Flow (high byte) 
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14 | oO | Status 

Flow (low byte) 

Flow 

Flow 

Flow (high byte) 
15 ra Status 

Flow (low byte) 

Flow 

Flow 

Flow (high byte) 

Valve (low byte) 

| 6 | Valve 

Valve 

8 | Valve (high byte) 
16 Poe Status 

Flow (low byte) 

Flow 

Flow 

Flow (high byte) 


5 | Setpoint (low byte) 


17 Oe Status 
Flow (low byte) 
Flow 
Flow 
Flow (high byte) 
Setpoint (low byte) 
Ea Setpoint 
Setpoint 
| 8 | Setpoint (high byte) 
i. 2 Valve (low byte) 


10 | Valve 
11 | Valve 


Valve (high byte) 
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18 | 0 | Status 
Flow (low byte) 
Flow 
Flow 
Flow (high byte) 
Setpoint (low byte) 
| 6 | Setpoint 
Setpoint 
i Bea Setpoint (high byte) 
Ea Override 
Valve (low byte) 


11 | Valve 
12 | Valve 


Valve (high byte) 
19 | 2202. Setpoint (low byte) 

Setpoint 

Setpoint 

Setpoint (high byte) 
20 i 20F-*) Override 

Setpoint (low byte) 

Setpoint 

Setpoint 

Setpoint (high byte) 


6-31.6 Mapping I/O Assembly Data Attribute Components 


Each of the S-Analog Sensor, S-Analog Actuator and S-Single Stage Controller object 
definitions specifies a behavior that modifies the Data Type of certain attributes based upon the 
first valid I/O connection established to an Assembly Object instance. In order to maintain 
consistency, this device type will only allow connections to either INT or REAL based 
Assembly instances. Once a valid connection is established, attempts to configure connections 
to a different type of Assembly instance will return an error. 


The following table indicates the I/O assembly Data attribute mapping for this MFC device. 
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Table 6-31.9 I/O Assembly Data Mapping 


Data Component Instance Attribute 


Name Number 
Flow S-Analog Sensor 31hex Indicated 
Flow 
Override S [S-Analog Actuator | Actuator Es [ [owes fF ss 
Setpoint S- ie Stage 33hex Setpoint 
Controller 
Status S-Device Supervisor | 30hex Exception BYTE 
Status 
Exception Detail S-Device Supervisor | 30hex Exception STRUCT 
Alarm Detail Alarm 
Exception Detail S-Device Supervisor | 30hex Exception 14 STRUCT 
Warning Detail 
Warning 
FP-Flow S-Analog Sensor 31hex Indicated REAL 
Flow 
FP-Setpoint S-Single Stage 33hex Setpoint REAL 
Controller 


6-31.7. Object Limitations and Specific Definitions 


This section describes limitations and specific definitions applicable to the listed objects of this 
device profile when these objects are applied in this type of device. 


6-31.7.1 | S-Device Supervisor Object Instance 


6-31.7.1.1 Limitations 
Table 6-31.10 Device Type Attribute Limitations 


Attribute Limitation 
Supported Values: 
“MFC” = Mass Flow Controller device 


“MFM” = Mass Flow Meter device 


Device Type 


6-31.7.1.2 Specific Definition 


The following table specifies the data attribute bit mapping for the Device Exception Detail 
bytes for this MFC device. For more descriptive information, see the definition of the S- 
Device Supervisor Object Class. Noted, for each entry, is the Object from which the Status 
byte/bit is mapped. See the object specification for the detailed bit mapping. 


Any Exception Bit not supported must default to 0. Note that this profile allows for only one 
byte of manufacturer specific exception detail. 
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Table 6-31.11 Device Exception Detail Attribute Mapping 
Data 


Bit 7 Bit 5 Bit 3 Bit 2 Bit 1 Bit 0 
Component 


MFC Device 

Exception Detail 

Size 

MFC Device Reserved | Reserved | Valve Valve Flow Flow Flow Reading 

Exception Detail High Low Control High Low Valid * 
S-Analog | S-Analog | S-Single | S-Analog | S-Analog | S-Analog 
Actuator | Actuator | Stage Sensor Sensor Sensor 

Controller 


Manufacturer 
Exception Detail 
Size 


Manufacturer 8 Bits defined by Manufacturer 
Exception Detail 


* Only used in the Warning Exception Detail, this bit is always = 0 in the Alarm Exception Detail. 


S-Analog Sensor Object Instance 


Limitations 
Table 6-31.12 Attribute Limitations 


Data Type Supported Values = {INT; REAL} Supported Values = {INT; REAL} INT 


Data Units Supported Values = {Counts & Units Supported Values = {Counts; Counts 
of the Flow Group} (see Appendix D) sccm} 
Offset-A 


Supported Values = {INT; REAL} Supported Values = {INT; REAL} INT 
Data Type 
Gain Data Supported Values = {INT; REAL} Supported Values = {INT; REAL} INT 
Type 


S-Analog Actuator Object Instance 


Limitations 
Table 6-31.13 Attribute Limitations 


Data Type Supported Values = {INT; REAL} Supported Values = {INT; REAL} INT 


Data Units Supported Values = {Counts, %, Supported Values = {Counts; %} Counts 


Voltage, Current & Units of the Flow 
Group} (see Appendix D) 


Gain Data Supported Values = {INT; REAL} Supported Values = {INT; REAL} INT 
Type 
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6-31.7.4 S-Single Stage Controller Object Instance 


6-31.7.4.1 Limitations 
Table 6-31.14 Attribute Limitations 


Data Type Supported Values = {INT; REAL} Supported Values = {INT; REAL} INT 


Data Units Supported Values = {Counts, %, Supported Values = {Counts; %} Counts 
Voltage, Current & Units of the Flow 
Group} (see Appendix D) 


Process Not accessible over the network. The A. N.A. 
Variable Process Variable input to this object 
instance is the value of the S-Analog 


Sensor object instance Value attribute. 


CV Data Not supported N.A. N.A. 
Type 


Control Not accessible over the network, The A. N.A. 
Variable Control Variable output from this 

object is the value of the S-Analog 

Actuator object instance Value 

attribute. 


6-31.8 Defining Device Configuration 


Public access to the S-Device Supervisor, S-Analog Sensor, S-Analog Actuator, S-Single Stage 
Controller, and S-Gas Calibration Objects by the Message Router must be supported for 
configuration of this device type. 
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6-32 Vacuum/Pressure Gauge Device 


Device Type: 1Crex 


The objective of this profile is to provide a vacuum or pressure measurement profile, which is 
inclusive of all technologies used to provide the pressure reading. By use of ”gauge” 
subclasses of the S-Analog Sensor, this profile can apply to Heat Transfer Gauges (Convection, 
Pirani, Thermocouple), Hot Cathode Ion Gauge, Cold Cathode Ion Gauge or a Diaphragm 
Gauge. The gauge subclasses provide calibration, control and status attributes unique to each 
gauge type. The S-Analog Sensor Object provides a pressure value to the Assembly instances 
delineated in this profile. 


Combination and Multiple Gauges 


This profile has been structured to facilitate use of Combination” gauges - multiple gauges 
each covering separate, contiguous ranges of pressure, only one gauge active and providing one 
Pressure Value at any particular time; and ’Multiple” gauges — in which all gauge readings are 
simultaneously available (but not necessarily valid). In both cases, multiple instances of the S- 
Analog Sensor Object are used. 


6-32.1 Object Model 


The Object Model in Figure 6-32.4 represents a Vacuum/Pressure Gauge Device. 


The table below indicates: 


e the object classes present in this device 
e whether or not the class is required 
e the number of instances present in each class 


Table 6-32.1 Objects Present in a Vacuum/Pressure Gauge Device 


Object Class # of Instances 
CIP Common Required Objects See Section 6-2.1 
Assembly At least 1 I/O and 1 
Explicit 
S-Device Supervisor 1 


S-Analog Sensor 1 Subclass required as a minimum 1 or more 


See S-Analog Sensor Subclasses in 
object model above. 


S-Gas Calibration 1 or more 
Discrete Output Point 1 or more 
Analog Output Point 1 or more 
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Class Subclasses 


Each class level subclass defines a unique meaning for an overlapping range of class attribute 
IDs and/or class service IDs. The range for subclass definitions begins at ID 96 and numbers 
downward for attributes, and ID 63), and numbers downward for services. The subclass for a 
given class is identified by the value of its Subclass class attribute. 


Table 6-32.2 S-Analog Sensor Class Level Object Subclasses 


Instance Subclass Name Subclass ID | Required Function Restrictions 
ID (Attribute 
99 Value) 


Class Instance Selector 01 Conditional* | Data Flow from None 
the Active Instance 


* Required for combination gauges only 
Instance Subclasses 
Each instance level subclass defines a unique meaning for an overlapping range of instance 
attribute IDs and/or instance service IDs. The range for subclass definitions begins at ID 96 
and numbers downward for attributes, and ID 63),., and numbers downward for services. The 
subclass for a given instance is identified by the value of its Subclass instance attribute. The 


following tables identify which object instance IDs are assigned subclasses for this device. 


Table 6-32.3 S-Analog Sensor Object Instance Level Subclasses 


Instance Subclass Name Subclass ID Required Function Restrictions 
ID (Attribute 99 
Value) 
* Heat Transfer 02 Conditional ** | Gauge Application | None 
Vacuum Gauge 
* Diaphragm Gauge 03 Conditional ** | Gauge Application | None 
Gauge 
‘i Cold Cathode Ion 04 Conditional ** | Gauge Application | None 
Gauge 
* Hot Cathode Ion 05 Conditional ** | Gauge Application | None 
Gauge 
* Instance IDs are vendor specific 


** The Gauge type Subclass is required if the referenced gauge type is implemented. 
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Figure 6-32.4 Object Model 
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6-32.4 How Objects Affect Behavior 


Table 6-32.5 Object Effect on Behavior 


Object Effect on behavior 


Identity Supports the Reset service. Upon receipt of a Reset Service 
Request of any Type, the Identity Object sends a Reset Service 
Request to the S-Device Supervisor. 


CIP Common Required See Section 6-2.2 for details. 
Assembly Defines input/output and configuration data format 
S-Device Supervisor Supports the Stop, Start, Reset, Abort, Recover and 


Perform_Diagnostic services for ALL Application Objects in the 
device and consolidates the Exception Conditions and Application 
Objects’ Status. 


This object behaves differently from the Identity Object in that the 
S-Device Supervisor object provides a single point of access to the 
Application Objects only; it does not effect the DeviceNet objects 
(i.e., Identity, DeviceNet, Connection, etc.). 


S-Analog Sensor Each instance of this object provides a calibrated pressure value 
from a pressure transducer. This object can also be used to supply 
an internal potentiometer position used for calibration purposes. 
Each instance will most likely use a gauge subclass; which 
subclass is used is determined by the gauge technology used. 


S-Gas Calibration Modifies the correction algorithm of the S-Analog Sensor object. 
The Gas Calibration Instance attribute of that object specifies 
which instance is active. 


Trip Point Provides a process trip point comparator for the S-Analog Sensor 
value. Each instance is linked to an S-Analog Sensor instance. 
The output of this object may be used to drive the Discrete Output 
Point object. 


Discrete Output Point Reflects status of Trip Point object instances. 


Analog Output Point Provides an Analog Output from the device which is fed from the 
S-Analog Sensor value. This analog value may be of a data type 
and data units different from those of the S-Analog Sensor. This 
object is required only if the output value is supported as visible to 
the network. 
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6-32.5 Defining Object Interfaces 


Table 6-32.6 Object Interfaces 


Object Interface 
CIP Common Required | See Section 6-2.3 for details. 
Assembly I/O Connection or Message Router 
S-Device Supervisor Assembly or Message Router 
S-Analog Sensor Assembly or Message Router 
S-Gas Calibration Message Router 
Trip Point Assembly or Message Router 


Discrete Output Point Message Router 


Analog Output Point Message Router 
6-32.6 I/O Assembly Instances 


The manufacturer of a Gauge Device must specify which Assembly instances are supported by 
the device. 


The S-Analog Sensor object definition specifies a behavior that modifies the Data Type of 
certain attributes based upon the first valid I/O connection established to an Assembly Object 
instance. In order to maintain consistency, this device type will only allow connections to either 
INT or REAL based Assembly instances. Once a valid connection is established, attempts to 
configure connections, or otherwise access data, to a different type of Assembly instance will 
return a RESOURCE UNAVAILABLE error. 


Combination Gauges 


Though the device supports multiple instances of the S-Analog Sensor class, only a single 
Pressure Value is produced in the Assemblies. The S-Analog Sensor class-level attribute 
Active Instance Number identifies the object instance that is currently active and providing its 
Pressure Value to the Active Pressure Value which is, in turn, produced by the input 
assemblies. Note that this behavior does not apply to the Trip Point and the Analog Output 
Point objects, which are directly linked to S-Analog Sensor instances. 


Multiple Gauges 


Multiple pressure values are available from multiple S-Analog Sensor instances and are 
provided in each assembly instance that contains multiple Pressure Value members indicated 
by Pressure Value n, where n corresponds to the S-Analog Sensor instance ID. The maximum 
number for n is specified by the value of the S-Analog Sensor object class attribute Number of 
Gauges. For devices with fewer gauges than the number specified in a given input assembly, 
the missing Data Components of that assembly will be set to zero (0). Note that for the purpose 
of bandwidth optimization, I/O connections to such assemblies where less than the included 
number of instances are valid, the I/O connection produce length can be set accordingly. 


The following table identifies the I/O assembly instances. The manufacturer must specify 
which Assembly instances are supported by the device. 
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Table 6-32.7 I/O Assembly Instances 


Instance | Required | Type | Byte | Bit 7 | Bit 6 | Bit5 | Bit 4 | Bit 3 | Bit 2 | Bit 1 | Bit 0 


al N Input |0-1 | INT Pressure Value 
2 Y Input | 0 Exception Status 
(default) 
1-2 |INT Pressure Value 
3 N Input | 0 Exception Status 
1 Trip Trip Trip Trip Trip Trip Trip Trip 
Status | Status | Status | Status | Status | Status | Status | Status 
Inst. 8 | Inst. 7 |Inst.6 | Inst.5 | Inst. 4 |Inst.3 | Inst. 2 | Inst. 1 
2-3 |INT Pressure Value 
4 N Input | REAL Pressure Value 
N 


Input Exception Status 
1-4 | REAL Pressure Value 


6 N Input Exception Status 
1 Trip Trip Trip Trip Trip Trip Trip Trip 
Status | Status | Status | Status | Status | Status | Status | Status 
Inst. 8 | Inst. 7 |Inst.6 |Inst.5 | Inst. 4 | Inst. 3 | Inst. 2 | Inst. 1 

2-5 |REAL Pressure Value 

7 N Input | 0 Exception Status 
1 Trip Trip Trip Trip Trip Trip Trip Trip 
Status | Status | Status | Status | Status | Status | Status | Status 
Inst. 8 | Inst. 7 |Inst.6 | Inst.5 | Inst. 4 | Inst. 3 | Inst. 2 | Inst. 1 

8 Input [Input }O | Exception Status 

Input |0-1 | Active Instance 

2-3 |INT Active Pressure Value 


Input Exception Status 
1-2 | Active Instance 
3-4 |INT Active Pressure Value 
0 ; 


11 N Input Exception Status 

1 Trip Trip Trip Trip Trip Trip Trip Trip 
Status | Status | Status | Status | Status | Status | Status | Status 
Inst. 8 | Inst. 7 |Inst.6 |Inst.5 | Inst. 4 | Inst. 3 | Inst. 2 | Inst. 1 

2- Active Instance 

4-5 |INT Active Pressure Value 

0 

2 


3 
12 N Input 1 
| -5 |REAL Active Pressure Value 
13 N Input | 0 Exception Status 
1-2 | Active Instance 
3-6 |REAL Active Pressure Value 


14 N Input | 0 Exception Status 
1 Trip Trip Trip Trip Trip Trip Trip Trip 
Status | Status | Status | Status | Status | Status | Status | Status 
Inst. 8 | Inst. 7 |Inst.6 |Inst.5 | Inst. 4 | Inst. 3 | Inst. 2 | Inst. 1 
2-3 | Active Instance 
4-7 |REAL Active Pressure Value 
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Instance | Required | Type | Byte | Bit 7 | Bit 6 | Bit5 | Bit 4 | Bit 3 | Bit 2 | Bit 1 | Bit 0 
15 N Input |}0-1 |INT Pressure Value 1 
NT Pressure Value 2 
NT Pressure Value 3 
NT Pressure Value 4 


I 
3 {I 
5 {I 
7 {I 
16 N Input Exception Status 
INT Pressure Value 1 
INT Pressure Value 2 
INT Pressure Value 3 
INT Pressure Value 4 


17 N Input Exception Status 


ee 
4- 
6 - 
0 
qi 
eee 
5 - 
Fr 
0 
1 


Trip Trip Trip Trip Trip Trip Trip Trip 
Status | Status | Status | Status | Status | Status | Status | Status 
Inst. 8 | Inst. 7 |Inst.6 |Inst.5 | Inst. 4 | Inst. 3 | Inst. 2 | Inst. 1 


INT Pressure Value 1 
INT Pressure Value 2 
INT Pressure Value 3 
INT Pressure Value 4 
REAL Pressure Value 1 
REAL Pressure Value 2 
REAL Pressure Value 3 


18 N Input 


REAL Pressure Value 4 


19 N Input Exception Status 
REAL Pressure Value 1 
REAL Pressure Value 2 


REAL Pressure Value 3 
REAL Pressure Value 4 


20 N Input Exception Status 


Trip Trip Trip Trip Trip Trip Trip Trip 
Status | Status | Status | Status | Status | Status | Status | Status 
Inst. 8 | Inst. 7 | Inst.6 |Inst.5 | Inst. 4 | Inst. 3 | Inst. 2 | Inst. 1 


REAL Pressure Value 1 
REAL Pressure Value 2 
REAL Pressure Value 3 


REAL Pressure Value 4 
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Instance | Required | Type | Byte | Bit7 | Bit6 | BitS | Bit4 | Bit3 | Bit2 | Bit1 | BitO 
21 N Input INT Pressure Value 1 
INT Pressure Value 2 
INT Pressure Value 3 
INT Pressure Value 4 
INT Pressure Value 5 
INT Pressure Value 6 


INT Pressure Value 7 


INT Pressure Value 8 


22 N Input Exception Status 

INT Pressure Value 1 
INT Pressure Value 2 
INT Pressure Value 3 
INT Pressure Value 4 
INT Pressure Value 5 


INT Pressure Value 6 


INT Pressure Value 7 


INT Pressure Value 8 


23 N Input Exception Status 


Trip Trip Trip Trip Trip Trip Trip Trip 
Status | Status | Status | Status | Status | Status | Status | Status 
Inst. 8 | Inst. 7 | Inst.6 |Inst.5 | Inst. 4 | Inst. 3 | Inst. 2 | Inst. 1 


INT Pressure Value 1 
NT Pressure Value 2 
NT Pressure Value 3 
NT Pressure Value 4 
NT Pressure Value 5 


I 
I 
I 
I 


INT Pressure Value 6 


INT Pressure Value 7 


INT Pressure Value 8 
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Instance | Required | Type | Byte | Bit7 | Bit6 | BitS | Bit4 | Bit3 | Bit2 | Bit1 | BitO 
24 N Input REAL Pressure Value 1 
REAL Pressure Value 2 
REAL Pressure Value 3 


REAL Pressure Value 4 


REAL Pressure Value 5 


REAL Pressure Value 6 


REAL Pressure Value 7 


REAL Pressure Value 8 


25 N Input Exception Status 


REAL Pressure Value 1 
REAL Pressure Value 2 
REAL Pressure Value 3 


REAL Pressure Value 4 
REAL Pressure Value 5 
REAL Pressure Value 6 
REAL Pressure Value 7 
REAL Pressure Value 8 


26 N Input Exception Status 


Trip Trip Trip |Trip | Trip Trip Trip Trip 
Status | Status | Status | Status | Status | Status | Status | Status 
Inst. 8 | Inst. 7 | Inst. 6 |Inst.5 | Inst. 4 | Inst. 3 | Inst. 2 | Inst. 1 


REAL Pressure Value 1 
REAL Pressure Value 2 
REAL Pressure Value 3 


REAL Pressure Value 4 


REAL Pressure Value 5 


REAL Pressure Value 6 


REAL Pressure Value 7 


REAL Pressure Value 8 
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Table 6-32.8 Output Assemblies for Hot Cathode Ion Gauges 


Inst ID | Req'd | Type | Byte Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 


200 Active Active Active Active Active Active Active Active 
Degas Degas Degas Degas Degas Degas Degas Degas 
Filament | Filament | Filament 6 | Filament | Filament | Filament | Filament | Filament 


8 7 5 4 3 2 1 


Filament | Filament | Filament | Filament | Filament 
5 4 3 2 1 


Filament | Filament | Filament 6 


8 7 


Emission Current 


Output 
reserved | reserved | reserved | reserved | reserved Clear Set Degas Set 
Emission State Emission 
Off Alarm | ON/OFF State 
ON/OFF 


If a fault condition occurs (for example overpressure emission off), the state of the ion gauge 
will be off and the fault condition must be cleared (Clear Emission Off Alarm) before pulling 
the "Set Emission State" and/or "Set Degas State" bits to zero then one again to light the ion 


gauge. 


Output - 
Active Active Active Active Active Active Active Active 
Filament | Filament | Filament 6 | Filament | Filament | Filament | Filament | Filament 
8 5 4 3 2 1 
reserved | reserved | reserved | reserved | reserved Clear Set Degas Set 
Emission ON/ Emission 
Off Alarm OFF ON/ 
OFF 
201 Output Active Active Active Active Active Active Active Active 
Filament | Filament | Filament 6 | Filament | Filament | Filament | Filament | Filament 
8 5 4 3 2 1 
reserved | reserved | reserved | reserved | reserved Clear Set Degas Set 
Emission State Emission 
Off Alarm | ON/OFF State 
ON/OFF 
202 Output Active Active Active Active Active Active Active Active 
Degas Degas Degas Degas Degas Degas Degas Degas 
Filament | Filament | Filament 6 | Filament | Filament | Filament | Filament | Filament 
8 7 5 4 3 2 1 
Active Active Active Active Active Active Active Active 
Filament | Filament | Filament 6 | Filament | Filament | Filament | Filament | Filament 
8 7 5 4 3 2 1 
| 2-5 | Emission Current 
reserved | reserved reserved reserved | reserved Clear Set Degas Set 
Emission State Emission 
Off Alarm | ON/OFF State 
ON/OFF 
203 4 i Active | Active | Active | Active | Active | Active | Active | Active 
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Table 6-32.9 Output assemblies for Cold Cathode Ion Gauges 


Inst ID | Req'd | Type | Byte Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 


N Output reserved | reserved | reserved | reserved | reserved Clear reserved | Set High 
Overpressure Voltage 
High Voltage State 
Off Alarm ON/OFF 
N Output 
4 reserved | reserved | reserved | reserved | reserved Clear reserved | Set High 
Overpressure Voltage 
High Voltage State 
Off Alarm ON/OFF 


um 
reserved | reserved | reserved | reserved | reserved Clear reserved | Set High 
Overpressure Voltage 
High Voltage State 
Off Alarm ON/OFF 


6-32.6.1 


High Voltage 


High Voltage 
Sensitivity 


If an fault condition occurs (for example overpressure emission off), the state of the ion gauge 
will be off and the fault condition must be cleared (Clear Overpressure Emission Off Alarm) 
before pulling the "Set High Voltage State" bit to "zero" then "one" again to light the ion 


gauge. 


All of the elemental components listed above follow standard CIP Data Encoding as specified 
in Appendix C. 


Mapping I/O Assembly Data Attribute Components 


The Data Type of the Pressure Value attribute below (and the Data Type of other objects used 
in this profile) is based upon the first valid I/O connection established to an Assembly Object 
instance. 


The following table indicates the I/O assembly Data attribute mapping for this Gauge device. 


Table 6-32.10 I/O Assembly Data Mapping 


Class Number Attribute 


Data Component 


Sub- Instance 
Name Class class Number Name Number | Type 
Pressure Value S-Analog Sensor 31 hex 1-N Value INT or 
REAL 


Exception Status | S-Device Supervisor | 30 hex | - | 1 | Bxception Status [12 | BYTE 


Active Instance S-Analog Sensor 31 hex Class Level | Active Instance | 95 UINT 
Number 


Active Pressure S-Analog Sensor 31 hex - Class Level | Active Value 94 INT or 
Value * REAL 
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6-32.7.1 
6-32.7.1.1 


Vacuum/Pressure oe Device, Type: 1Cyrex 


| Class Number _| Number Attribute 
Sub- Instance 
Class class Number 


Data Component 


Name 
Active Degas S-Analog Sensor | 31 hex 1-N_ | Active Degas BYTE 
Filament Filament 
Active Filament | S-Analog Sensor | 31 hex 5 1-N Active Filament | 89 BYTE 
High Voltage S-Analog Sensor | 31 hex 4 1-N High Voltage | 91 REAL 
Sensitivity S-Analog Sensor | 31 hex 4 1-N Sensitivity 92 REAL 
Service 
setting/resetting these bits to 0 or 1 in the I/O 
Class assembly is equivalent to performing the 
Number service with the value 0 or 1 

Data Component | Class Sub- | Instance 
Name 

class | Number | Service Name Service Code | Type 
Set Degas State |S-Analog Sensor | 31 5 1-N_ | Set Degas State | 61 hex BOOL 
On / Off hex 
Set Emission S-Analog Sensor | 31 5 1-N_ | Set Emission 62 hex BOOL 
State On / Off hex State 
Clear Emission | S-Analog Sensor | 31 5 1-N_ |ClearEmission | 63 hex BOOL 
Off Alarm hex Off Alarm 
Set High S-Analog Sensor | 31 4 1-N_ | Set High 62 hex BOOL 
Voltage State On hex Voltage State 
/ Off 
Clear S-Analog Sensor | 31 4 1-N_ | Clear 63 hex BOOL 
Overpressure hex Overpressure 
High Voltage High Voltage 
Off Alarm Off Alarm 


* For Combination Gauges only 
Object Limitations and Specific Definitions 


S-Device Supervisor Object Instance 


Exception Attributes Definition 


The following table specifies the data attribute bit mapping for the Device Exception Detail 
bytes for this device. For more descriptive information, see the definition of the S-Device 
Supervisor Object Class. 


All status and ”Sensor” bits originate from the S-Analog Sensor object. The meaning of Sensor 
Alarm and Sensor Warning is defined by the Gauge Subclass used. See the object specification 
for the detailed bit mapping. Noted with each entry is the Instance from which the status 
byte/bit is mapped. 


Combination and multiple gauges will have a set of Device Exception details for each gauge. 
The S-Analog Sensor class attribute Number of Gauges is used to determine gauge count. 


Any Exception Bit not supported shall be set to zero (0). Note that this profile allows for only 
one byte of manufacturer exception detail. 
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Table 6-32.11 Exception Detail a (Attribute 14) for single ae 


Data Component | Bit7 | Bité | BitS| Bit4 | Bic3| Bit2 | Bita | Biro 


Device Exception Detail Warning 
Size 


Device 1 Exception Detail S-Analog Sensor object Instance 1 — Status Extension 
Warning Byte 0 
Device 1 Exception Detail S-Analog Sensor object Instance 1 — Sensor Warning — Byte 0 


Warning Byte 1 


Device 1 Exception Detail S-Analog Sensor object Instance 1 — Sensor Warning — Byte 1 
Warning Byte 2 


Manufacturer Exception Detail 
Warning Size 


Manufacturer Exception Detail 8 bits defined by Manufacturer 


Warning 


Table 6-32.12 Exception Detail Warning (Attribute 14) for combination and SS 


Data Component Bit 7 epic ein | es a Bi | Bee | Bit1 | 1 Bit 0 


Size 


Device 1 Exception Detail S-Analog Sensor object Class Level Status Extension 

Warning Byte 0 

Device 1 Exception Detail S-Analog Sensor object Instance 1 — Sensor Warning — Byte 0 
Warning Byte 1 

Device 1 Exception Detail S-Analog Sensor object Instance 1 — Sensor Warning — Byte 1 
Warning Byte 2 


Device N Exception Detail 
Warning Byte 0 


S-Analog Sensor object Instance N — Sensor Warning — Byte 0 


Device N Exception Detail 
Warning Byte 1 


S-Analog Sensor object Instance N — Sensor Warning — Byte 1 


Manufacturer Exception Detail 
Warning Size 


Manufacturer Exception Detail 
Warning 


| Bit7 | ie ees eee ee | Bit2 | Bit | 


Device 1 Exception Detail (Alarm) | S-Analog Sensor object Instance 1 — Sensor Alarm — Byte 0 
Byte 0 


Device 1 Exception Detail (Alarm) | S-Analog Sensor object Instance 1 — Sensor Alarm — Byte 1 


Device Exception Detail (Alarm) 
Size 


Combination and Multi-Gauge Devices Only: 


Device N Exception Detail (Alarm) | S-Analog Sensor object Instance N — Sensor Alarm — Byte 0 
Byte 0 
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ray [mice [aes [wis [aia | we [wi | 


Device N Exception Detail (Alarm) | S-Analog Sensor object Instance N — Sensor Alarm — Byte 1 


Data Component 


[End Combination and Multi-Gauge Devices Only] 


Manufacturer Exception Detail 
(Alarm) Size 


Manufacturer Exception Detail 
(Alarm) 


8 bits defined by Manufacturer 


6-32.7.1.2 Manufacturer’s Device Type Attribute Definition 


The following limitations apply: 


Table 6-32.14 Device Type Attribute Limitations 


Attribute Need in Access | Name | Data Type Description of Attribute 
ID implementation} Rule 


Supported values: 

”*VG” for single-instance vacuum gauge 
”CG” for combination gauge 

”MG” for multiple gauge 


(ref S-Analog Sensor instance attribute Subclass 
Number to determine specific gauge type) 


6-32.7.1.3 Behavior 


The behavior of all Pressure/Vacuum Gauge objects are defined by the S-Device Supervisor 
Object in Chapter 5. 


Ion Gauges only — the Emission OFF state will result in the following behavior: 


a) S-Analog Sensor Value attribute will revert to the Safe State / Safe Value, if supported. 
This mimics the non-executing state of the device. 

b) The Trip Point (if supported) Status attribute will be set to the unasserted state (Override, 
if supported, = 1). 


6-32.7.2 S-Analog Sensor Object Instance 


6-32.7.2.1 Limitations 
6-32.7.2.1.1 Object Instance Number Assignment 


The following instance numbering limitations apply: 


Table 6-32.15 Object Instance Number Limitations 


Instance Description 


Reserved for Pressure Gauges 


21... 60 Reserved for Interlock-Relay Setting Monitors 
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6-32.7.2.1.2 Data Type, Data Units and Produce Trigger Delta Type 


The following attribute limitations apply: 


Table 6-32.16 Data Limitations 


Attribute Additions / Limitation Requirements 


Data Type Supported Values = {INT, REAL} Supported Value 
Access Rule = Get only, after an assembly = {INT} 
instance connection is established 

Data Units Supported Values limited to those found in Supported Value 
”Group 4 — Pressure” of Data Units Appendix K, = {Counts} 


and Counts. 


Produce Trigger Percent Percent 
Delta Type 


All devices are required to support INT Counts. The meaning of Counts is vendor-specific. 
Which combinations of Data Units and Data Type are supported are vendor-specific. INT 
Counts and/or REAL Pressure Units are the most likely options. Other combinations (ex. 
REAL Counts) may not be supported. 


Multiple gauges and combination gauges will require multiple instances of the S-Analog 
Sensor Object, all of which will support the same Data Type and Data Units. 
6-32.7.2.1.3 Alarm and Warning Hysteresis (attributes 19 and 23) 


For gauges with a logarithmic vacuum reading (hot cathode ion gauge, cold cathode ion gauge, 
and heat transfer gauges) the Alarm and Warning Hysteresis attributes determine the amount 
(in the unit "percent of the associated alarm/warning value" ) by which the Value must recover 
to clear an Alarm Condition. 


For gauges with a linear vacuum reading (Diaphragm Gauge) the Alarm and Warning 


Hysteresis attributes determine the amount (absolute) by which the Value must recover to clear 
an Alarm Condition. 


6-32.7.2.2 Object Extensions 


This profile uses the extensions for the following instance-level subclasses: 


Table 6-32.17 Object Extensions for Instance-level Subclasses 


Gauge Type Subclass Number 
Heat Transfer Vacuum Gauge | 02 
Diaphragm Gauge 03 
Cold Cathode Ion Gauge 04 
Hot Cathode Ion Gauge 05 
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6-32.7.3 Trip Point Object Instance 
6-32.7.3.1 Limitations 
6-32.7.3.1.1 Hysteresis (attribute 10) 


For gauges with a logarithmic vacuum reading (hot cathode ion gauge, cold cathode ion gauge, 
and heat transfer gauges) the Hysteresis attribute determines the amount (in the unit "percent of 
the associated low/high trip point" ) by which the Value must recover to clear a trip point 
condition. 


For gauges with a linear vacuum reading (Diaphragm Gauge) the Hysteresis attribute 


determines the amount (absolute) by which the Value must recover to clear a trip point 
condition. 


6-32.7.3.1.2 Source (attribute 14) 


Abbreviated EPATH — the Source attribute in this device type is abbreviated as follows: 
Logical Segment, Instance Only, 8-bit Logical Address (see Appendix C). 
The following defaults apply: 


Class ID = 31hex [S-Analog Sensor]. 
Attribute ID = 06 [Value]. 


Therefore, the source attribute uses the following encoding: 


Table 6-32.18 Source Attribute Encoding 


2Anex x 


Where x is the Instance ID of the S-Analog Sensor object whose Value attribute is the source. 


6-32.7.3.1.3 Destination (attribute 12) 


Abbreviated EPATH — the Destination attribute in this device type is abbreviated as follows: 
Logical Segment, Instance Only, 8-bit Logical Address (see Appendix C). 
The following defaults apply: 


Class ID = 09hex [Discrete Output Point]. 
Attribute ID = 03 [Value]. 


Therefore, the Destination attribute uses the following encoding: 


Table 6-32.19 Destination Attribute Encoding 


24nex x 


Where x is the Instance ID of the Discrete Output Point object whose Value attribute is the 
Destination. 
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6-32.8 Defining Device Configuration 


Public access to the S-Device Supervisor, S-Gas Calibration, and S-Analog Sensor Objects by 
the Message Router must be supported for configuration of this device type. There is no 
Parameter Object defined for access to the device type’s configuration parameters. 


— 6-179 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 6: Device Profiles, Part 4 


ControlNet Programmable Logic Controller Device, Type: 0E Hex 


6-33 Programmable Logic Controller Device 


Device Type: 0E hex 


The Programmable Logic Controller Device type defines a device that acts as a programmable 
logic controller. No control functions are included in this profile. 


6-33.1 Object Model 


The table below indicates: 


e the object classes present in this device 
e whether or not the class is required 
e the number of instances present in each class 


Table 6-33.1 Objects Present in a Programmable Logic Controller Device 


Object Class Optional/Required # of Instances 
CIP Common Required Objects See Section 6-2.1 


The Programmable Logic Controller Device profile cannot specify the definition of the 
Assembly Object or the type of application objects necessary for device operation. This portion 
of the device profile must be supplied by the product developer as described earlier in this 
chapter, Contents of a Device Profile. 


6-33.2 Defining Object Interfaces 


The objects in the Programmable Logic Controller Device have the interfaces listed in the 
following table: 


Table 6-33.2 Object Interfaces 


Object Interface 
CIP Common Required | See Section 6-2.3 for details. 
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6-34 ControlNet Physical Layer Component Device 


Device Type: 32 hex 


The ControlNet Physical Layer Component shall not be addressable from the link. This device 
type shall include repeaters and various media for the ControlNet physical layer. 
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6-35 Process Control Valve Device 
Device Type: 1D hex 


A Process Control Valve (PCV) is a device that controls a process condition. This can be 
physically located before or after a process vessel, container or chamber, therefore controlling 
the entry or exit of fluid / gas to / from a process chamber. It contains a controller that employs 
closed loop control by receiving a set point and driving the internal actuator such that the 
process variable is controlled to the set point. The value of the process variable can be 
obtained either through digital or analog connections. The controller operates in either of two 
modes. One mode of operation is closed loop process control. The second drives the control 
valve directly to a position. 


6-35.1 Object Model 
The Object Model in Figure 6-35.2 represents a Process Control Valve Device. The table below 
indicates: 


e the object classes present in this device 
e whether or not the class is required 
e the number of instances present in each class 


Table 6-35.1 Objects Present in a Process Control Valve Device 


Object Class Optional/Required # of Instances 
CIP Common Required Objects | Required See Section 6-2.1 
Assembly Required at least 2 Input and 2 Output 
S-Device Supervisor Required 1 
S-Analog Sensor Optional 7 
S-Analog Actuator Required 
S-Single Stage Controller Required 1to2 


N 


Selection Conditional ** 


Trip Point Optional 1 or more 


N 


Discrete Input Point Optional 


BR 


Discrete Output Point Optional 1 or more 


* depends on implementation 
** Required if two S-Single State Controller Objects are supported. 
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Figure 3-35.2 Object Model for the Process Control Valve Device 
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6-35.2 How Objects Affect Behavior 


Table 6-35.3 Object Affect on Behavior 


Object Effect on behavior 


Identity Supports the Reset service. Upon receipt of a Reset Service Request 
of any Type, the Identity Object sends a Reset Service Request to the 
S-Device Supervisor. 


See Section 6-2.2 for details. 
CIP Common Required 
Assembly Defines input/output and configuration data format 


S-Device Supervisor Supports the Stop, Start, Reset, Abort, Recover and 
Perform_Diagnostic services for ALL Application Objects in the 
device and consolidates the Exception Conditions and Application 
Objects’ Status. 


This object behaves differently from the Identity Object in that the S- 
Device Supervisor object provides a single point of access to the 
Application Objects only; it does not affect the DeviceNet specific 
objects (i.e., Identity, DeviceNet, Connection, etc.). 


S-Analog Sensor Monitors the optional analog process variable input(s), and feeds the 
process variable value to the Single Stage Controller object. Also, 
optionally monitors the position of the control valve, as well as other 
signal levels in the device for diagnostic purposes. 


S-Analog Actuator Drives the physical valve. 


S-Single Stage Controller | Calculates the Control Variable required to drive the control valve of 
the device. Both instances may be present but only one instance is 
active at any time. 


Selection Provides a means of configuring data flow with the device profile. 


Trip Point Provides a process trip point comparator for the S-Single Stage 
Controller Process variable value. Each instance is linked to an S- 
Single Stage Controller instance. The output of this object may be 
used to drive the Discrete Output Point object. 


Discrete Input Point Monitors the state of the optional limit switches of the device control 
valve. 
Discrete Output Point Reflect status of Trip point object instances. One Discrete Output 


Point can be assigned to a Trip Point obect. 
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6-35.3 Defining Object Interfaces 


Table 6-35.4 Object Interfaces 


Object Interface 
CIP Common Required See Section 6-2.3 for details. 
Assembly I/O Connection or Message Router 
S-Device Supervisor Assembly or Message Router 
S-Analog Sensor Assembly or Message Router 
S-Analog Actuator Assembly or Message Router 


S-Single Stage Controller | Assembly or Message Router 


Selection Assembly or Message Router 
Trip Point Assembly or Message Router 
Discrete Input Point Assembly or Message Router 
Discrete Output Point Message Router 


6-35.3.1 I/O Assembly Instances 


The following table identifies the I/O assembly instances supported by the PCV. 


The S-Analog Sensor and S-Single Stage Controller object definition specifies a behavior that 
modifies the Data Type of certain attributes based upon the first valid I/O connection 
established to an Assembly Object instance. In order to maintain consistency, this device type 
will only allow connections to either INT or REAL based Assembly instances. Once a valid 
connection is established, attempts to configure connections, or otherwise access data, to a 
different type of Assembly instance will return a RESOURCE UNAVAILABLE error. 


Table 6-35.5 I/O Asembly Instances 


Number | Required | Type | Byte | Bit7 | Bit6 | Bits | Bit4 | Bir3 | Bit2 | Bit1] Bito 
1 INT Process Variable 
2 Y Input 0 Exception Status 
1-2 Process Variable 
N Input 0 Exception Status 
1-2 Process Variable 
3-4 Valve 
N Input 0 Exception Status 
N 
Y 


1-2 Process Variable 
3-4 Control Setpoint 


5 N Input 0 Exception Status 
1-2 Process Variable 
3-4 Control Setpoint 

Valve 


Exception Status 
Process Variable 
Control Setpoint 
Control Mode 
Valve 


7 Output | 0-1 Control Setpoint 
(default) 2-3 Control Instance 
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Number | Required | Type | Byte | Bit7 | Bit6é | Bits | Bit4 | Bic3 | Bit2 | Bit1] Bito 
8 N Output |0 Control Mode 
1-2 Control Setpoint 
3-4 Control Instance 
9 N Control Mode 
Control Setpoint 
3-4 Control Instance 
5-6 Process Variable 
10 Exception Status 
11 N Input 0 Exception Status 
1-2 Process Variable 
3-4 Valve 
5 Dicsrete | Discrete 
Input 2 | Input 1 
12 N Input 0 Exception Status 
1-2 Process Variable 
3-4 Flow 
13 N Input 0 Exception Status 
1-2 Process Variable 
3-4 Valve 
5-6 Flow 
14 Process Variable 
15 N Input 0 Exception Status 
1-2 Process Variable 
3-4 Temperature 
16 N Input 0 Exception Status 
1-2 Process Variable 
3-4 Flow 
5-6 Temperature 
17 FP-Process Variable 
18 Y Input 0 Exception Status 
1-4 FP-Process Variable 
19 N Input 0 Exception Status 
1-4 FP-Process Variable 
5-8 FP- Valve 
20 N Input 0 Exception Status 
FP- Process Variable 
FP- Control Setpoint 
21 N Exception Status 
FP-Process Variable 
FP-Control Setpoint 
FP- Valve 
22 N Exception Status 
FP-Process Variable 
FP-Control Setpoint 
Control Mode 
FP- Valve 
23 Y Output | 0-3 FP-Control Setpoint 
4-5 Control Instance 
24 N Output |0 Control Mode 
FP-Control Setpoint 
Control Instance 
25 N Control Mode 
FP-Control Setpoint 
Control Instance 
FP-Process Variable 
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Number | Required | Type | Byte | Bit7 | Bité | Bits | Bit4 | Bit3 | Bit2 | Bit1| Biro 
26 Input 0 Exception Status 

1-4 FP-Process Variable 

5-8 FP-Valve 


9 Discrete | Discrete 
Input 2 | Input 1 
Input 0 Exception Status 
FP-Process Variable 
FP-Flow 
Exception Status 
FP-Process Variable 
FP-Valve 
FP-Flow 
Output | 0-3 FP-Process Variable 
Input 0 Exception Status 
FP-Process Variable 
FP-Temperature 
Exception Status 
FP-Process Variable 
FP-Flow 
FP-Temperature 
Control Mode 
FP-Control Setpoint 
Kp 
Ki 
Kd 


27 


28 


29 
30 


31 


32 


The manufacturer of a Process Control Valve Device must specify which optional Assembly 
instances are supported by the device. 
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6-35.3.2. Mapping I/O Assembly Data Attribute Components 


The Data Type of the objects in this profile are based upon the first valid I/O Connection 


established to an Assembly Object instance. See text of 6-35.4.1. 


The following table indicates the I/O assembly Data attribute mapping for this PCV device. 


Table 6-35.6 I/O Assembly Data Mapping 


Status S-Device Supervisor 


Value 


: ra ee 


K 


um} 


Poportional Gain 


* As specified by S-Single Stage Controller Data Type attribute. 
** As specified by S-Analog Sensor Data Type attribute. 


6-35.4 Object Limitations and Specific Definitions 


6-35.4.1 | S-Device Supervisor Object 
The following attribute limitations apply: 


Table 6-35.7 Device Type Attribute Limitations 


Attribute Limitation 


Supported Values: 
“PCV” = Process Variable Control Valve device 


Device Type 
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Controller 


Control Mode | S-Single Stage 
emai 


Exception Status = 


94 


Type 
ok 
oka 
RK 


oko 
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Exception Attributes Definition 


The following table specifies the data attribute bit mapping for the Device Exception Detail 
bytes for this PCV device. For more descriptive information, refer to the definition of the S- 
Device Supervisor Object Class (and, in particular, the Semantics of the Exception Detail 
Alarm and Exception Detail Warning attributes). Noted, for each entry, is the Object and 
Instance from which the Status byte/bit is mapped. Refer to the object specification for the 


detailed bit mapping. 


Any Exception Bit not supported must default to 0. Note that this profile allows for only one 
byte of manufacturer specific exception detail. 


Table 6-35.8 Data Attribute Bit Mapping 


Data Component Bit 0 
Name 
PCV Device 1 
Exception Detail 
Size 
PCV Device Process Process Position Process Process Process Not 
Exception Detail | Variable Variable Reading Control Variable Variable Variable Reading 
Byte #0 High Low Valid S-Single Control High Low Valid 
S-Analog |S-Analog |S-Analog | Stage S-Single S-Analog |S-Analog | S-Analog 
Sensor Sensor Sensor Controller | Stage Sensor Sensor Sensor 
(2) (2) (2) (2) Controller | (1) (1) (1) 
(1) 
PCV Device Temp. Not Flow Flow Not Valve Valve Not 
Exception Detail | Low Reading High Low Reading High Low Reading 
Byte #1 S-Analog | Valid * S-Analog |S-Analog | Valid * S-Analog |S-Analog | Valid * 
Sensor S-Analog | Sensor Sensor S-Analog | Sensor Sensor S-Analog 
(5) Sensor (4) (4) Sensor (3) (3) Sensor 
(5) (4) (3) 
PCV Device Not Auxiliary | Auxiliary | Not DeviceNet | DeviceNet | Not Temp. 
Exception Detail | Reading Input High | Input Low | Reading 24V 24V Reading High 
Valid * S-Anal q Valid * oh eK ek Valid * “ 
Byte #2 nalog | S-Analog High Low S-Analog 
S-Analog | Sensor Sensor S-Analog | s_ Analog | S-Analog S-Analog | Sensor 
Sensor (7) (7) Sensor Sensor Sensor Sensor (5) 
(8) (7) (6) (6) (6) 
PCV Device Device Device Not Device Device Not Logic 5V_ | Logic 5V 
Exception Detail | -15V High |-15V Low | Reading +15V High | +15V Low | Reading High Low 
Byte #3 S-Analog |S-Analog | Valid * S-Analog |S-Analog | Valid * S-Analog | S-Analog 
Sensor Sensor S-Analog | Sensor Sensor S-Analog | Sensor Sensor 
(10) (10) Sensor (9) (9) Sensor (8) (8) 
(10) (9) 
PCV Device Reserved |Reserved |Reserved | Reserved |Reserved | Reserved | Status Status 
Exception Detail Discrete Discrete 
Byte #4 Input Point | Input Point 
(2) (1) 
Manufacturer 1 
Exception Detail 
Size 
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Data Component Bit 7 Bit 5 Bit 3 Bit 2 Bit 1 Bit 0 
Name 


Manufacturer | 8 Bits 
Exception Detail | defined by 
Manufact- 
urer 


* Only used in the Warning Exception Detail, this bit is always = 0 in the Alarm Exception Detail. ‘Not’ indicates the use 
of the negation of ‘Reading Valid’. 


** Not supported if CIP network is not DeviceNet. Shall be zero. 


6-35.4.2 S-Analog Sensor Object 


This section provides the additional components and specifications for this object as it applies 
to this profile. 


The temperature instance is location specific to each manufacturer, if supported. The physical 
location of the actual temperature sensor the instance reports is determined by the 


manufacturer. 


The following instance limitations apply: 


Table 6-35.9 Instance Limitations 


Instance Description Subclass 
1 Process Variable Input #1 (Low Range) 06 * 
2 Process Variable Input #2 (High Range) 06 * 
3 Control Valve Position Feedback none 
4 Flow Sensor none 
5 Temperature Sensor none 
6 DeviceNet 24V Power Input none 
wh Auxiliary Voltage Input none 
8 Logic 5V none 

Device +15V none 
10 Device -15V none 


* S-Analog Sensor Object Instance Subclass 06 - Transfer Function 


The following attribute limitations apply: 
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Table 6-35.10 Attribute Limitations 


Data Type All Supported Values = {INT; REAL} INT 
Access Rule = Get only, after an assembly instance 
connection is established 
Data Units 1,2 Supported Values = {Counts, Percent, Torr, mTorr, Counts 
Bar, mBar, Pa, kPa} 
Supported Values = {Counts, Percent, Degrees} 
Supported Values = {Counts, Percent, SCCM, SLM} 
Supported Values = {Counts, Centigrade, Fahrenheit} 
Supported Values = {Counts, Percent, Volts} 
6,7,8,9,10 
Offset-A All Supported Values = {INT; REAL} INT 
Data Type 
Gain Data All Supported Values = {INT; REAL} INT 
Type 
All 


Value For: 
Data Units = Counts 
Data Type = INT 
7FFF = 140% of Full Scale Sensor Reading 
0000 = 0 
8000 = -140% of Full Scale Sensor Reading 


S-Single Stage Controller Object 


The following instance limitations apply: 


Table 6-35.11 Instance Limitations 


1 Process Variable Control 01 * 
2 Control Valve Position none 


* S-Single Stage Controller Object Instance Subclass 01 - PID and Source Select 


The following attribute limitations apply: 


Table 6-35.12 Attribute Limitations 


Attribute Limitation Requirements 
Data Type Supported Values = {INT; REAL} INT 


Access Rule = Get only, after an assembly instance 
connection is established 


Data Units / Instance 1 Supported Values = {Counts, Percent, Torr, mTorr, | Counts 
Bar, mBar, Pa, kPa} 


Data Units / Instance 2 Supported Values = {Counts, Percent, Degrees} Counts 
0 = closed 


Process Variable Shall be supported 
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6-35.4.4 Selection Object 


The following instance limitations apply: 


Where supported, this profile requires the Selection Object Revision 2 or higher. 


Table 6-35.13 Instance Limitations 


Instance Description 
Setpoint 


Control Variable 


The following attribute values shall be assigned for Instance 1: 


Table 6-35.14 Attribute Limitations — Instance 1 


Attribute Limitation (assigned values are shown in hex format) 
max_destinations 02 
number_of_destinations 02 
destination_list 06 / 20 / 33 / 24/01/30 /06— S-Single Stage Controller, Instance 1, setpoint 


06 / 20 / 33 / 24/02 / 30 / 06 — S-Single Stage Controller, Instance 2, setpoint 
Access Rule = Get Only 


max_sources 00 

number_of_sources 00 

source_list Not Supported 

source_used 00 

algorithm_type 04 — Programmable Data Flow 


Access Rule = Get Only 
object_source_list 00 
Access Rule = Get Only 


destination_used Range = 0-2 


The following attribute values shall be assigned for Instance 2: 


This object instance is not able to be configured over the network. Its purpose is to function as 
an automatic Data Flow selection mechanism. 
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Table 6-35.15 Attribute Limitations — Instance 2 


Attribute Limitation (assigned values are shown in hex format) 
max_destinations 01 
number_of_destinations 01 
destination_list 06 / 20 / 32 / 24/01/30 /06— S-Analog Actuator, Instance 1, Value 
Access Rule = Get Only 
max_sources 02 
number_of_sources 02 
source_list Not Supported 
source_used Range =1-2 


Access Rule = Get Only 
algorithm_type 04 — Programmable Data Flow 
Access Rule = Get Only 


object_source_list 06 / 20 / 33 / 24/01/30 / 09 — S-Single Stage Controller, Instance 1, Control 
Variable 


06 / 20 / 33 / 24/02/30 / 09 — S-Single Stage Controller, Instance 2, Control 
Variable 


Access Rule = Get Only 
destination_used 01 
Access Rule = Get Only 


6-35.4.5 Discrete Input Point Object 
The following instances shall be applied as follows: 


Table 6-35.16 Instances 


Instance Description 
Close Limit Switch 


Open Limit Switch 


It is recommended that these object instances support the Off_On Cycles attribute. 


6-35.5 Defining Device Configuration 


Public access to the S-Device Supervisor, S-Analog Sensor, and S-Single Stage Controller 
Objects by the Message Router must be supported for configuration of this device type. 


For the Data Units for the S-Analog Sensor Object instances one through four are for process 
inputs, the S-Single Stage Controller Object’s Setpoint and the S-Single Stage Controller 
Object’s Process Variable will be self-modifying for any change in Data Units to any other of 
these attributes. The self-modified value shall give consistency of Data Units to all these 
instances. This is defined by the class level attributes of Control Insurance and Control 
Setpoint. 
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6-36 Turbomolecular Vacuum Pump Device 


Device Type: 21 hex 


A Turbomolecular Vacuum Pump (Turbo Pump) is a type of vacuum pump. A vacuum pump 
is a device that is used for pumping air and other gasses for the purposes of generating negative 
pressures on its inlet port. 


The Turbo Pump device is composed of a motor, a mechanical (turbomolecular) pumping 
apparatus and various electronic control elements. Typically, thermal management represents 
another component of the device. 


6-36.1 Object Model 
The Object Model in Figure 6-36.2 represents a Turbo Pump Device. The table below 
indicates: 


e the object classes present in this device 
e whether or not the class is required 
e the number of instances present in each class 


Table 6-36.1 Objects Present in a Turbo Pump Device 


Object Class # of Instances 
CIP Common Required Objects See Section 6-2.1 
Assembly at least 2 Input and 2 Output 
S-Device Supervisor 1 
Register Oor1 
Discrete Input Point 1 
Discrete Output Point 1,20r3 
AC/DC Drive 1 
S-Analog Sensor as many as 5 
S-Single Stage Controller Oorl 


6-36.2 Class Subclasses 


Each class level subclass defines a unique meaning for an overlapping range of class attribute 
IDs and/or class service IDs. The range for subclass definitions begins at ID 96 and numbers 
downward for attributes, and ID 63), and numbers downward for services. The subclass for a 
given class is identified by the value of its Subclass class attribute. 


There are no Class Level Subclasses specified for the Turbo Pump device. 


6-36.3. Instance Subclasses 


Each instance level subclass defines a unique meaning for an overlapping range of instance 
attribute IDs and/or instance service IDs. The range for subclass definitions begins at ID 96 
and numbers downward for attributes, and ID 63;., and numbers downward for services. The 
subclass for a given instance is identified by the value of its Subclass instance attribute. 


There are no Instance Level Subclasses specified for the Turbo Pump device. 
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Figure 6-36.2 Object Model for the Turbo Pump Device 
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How Objects Affect Behavior 


Table 6-36.3 Object Affect on Behavior 


Object 


Effect on behavior 


Identity 


Supports the Reset service. Upon receipt of a Reset Service 
request, a similar request is passed to the S-Device Supervisor. 


CIP Common Required See Section 6-2.2 for details. 


Assembly 


Defines input/output and configuration data format 


S-Device Supervisor 


Register 


Supports the Stop, Start, Reset, Abort, Recover and 
Perform_Diagnostic services for ALL Application Objects in 
the device and consolidates the Exception Conditions and 
Application Objects’ Status 


Vent Valve configuration settings 


Discrete Input Point 


Discrete Output Point 


No effect 


Turns pump on and off and affects the states of the Bakeout 
Heater and Purge Valve. The value of Discrete Output Point 
Object instance 1, Value attribute (ID 3) is sent to AC/DC Drive 
Object instance 1, Speed Control attribute (ID 38) Bit 0 (Run 
Request). 


AC/DC Drive 


Manages the operation of the pump motor. The value of the 
Speed Status attribute (ID 39) Bit 0 (Running) is sent to 
Discrete Input Point object instance 1, Value attribute (ID 3). 


S-Analog Sensor 


Alarm Trip Points may cause the pump to shut down as 
specified. Feeds values to the Process Variables of S-Single 
Stage Controllers. 


S-Single Stage Controller 


Control various temperature zones in the pump assembly 


Defining Object Interfaces 


Table 6-36.4 Object Interfaces 


Object 


Interface 


CIP Common Required See Section 6-2.3 for details. 


Assembly 


I/O Connection or Message Router 


S-Device Supervisor 
Register 


Assembly or Message Router 
Assembly or Message Router 


Discrete Input Point 


Assembly or Message Router 


Discrete Output Point 


Assembly or Message Router 


AC/DC Drive 
S-Analog Sensor 


Assembly or Message Router 
Assembly or Message Router 


S-Single Stage Controller 


Assembly or Message Router 
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6-36.6 I/O Assembly Instances 


The manufacturer of a Turbo Pump Device must specify which Assembly instances are 
supported by the device. 


The following table identifies the I/O assembly instances. 


Table 6-36.5 I/O Assembly Instances 


Instance — Type | Byte | Bit7 | Bit6 | BitS | Bit4 | Bit3 | Bit2 | Bit1 | Bito 


Input 
aaais 


Exception Status 


Speed Status 


Pump 
On 
Status 
Exception Status 


Speed Status 


Pump 
On 
Status 
Pump Speed 


Exception Status 


Speed Status 


Pump 
On 
Status 
Pump Speed 


Coil Temp 


Current 


N wu} w NI] Ul] Ww 
1 = o|rF 1 1 NTR 1 1 1 N]Re 
w oon mn look oon mr 


4 Exception Status 
Speed Status 
Pump 
On 
Status 
Pump Speed 
Inlet Pressure 
5 Pump 
On 
6 Pump 
On 
Speed Control 
7 0 0 0 0 0 0 0 Pump 
On 
Speed Control 
Speed Target 
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Speed Control 


Pressure Target 


Speed Scale 
Speed Data Units 
High Speed Limit 

Speed Target Data Units 

Speed Target 

Time Scale 
Accelerate Time 
Deceleration Time 
Speed Trip Time 

Current Scale 


Current Limit 


10 Drive Mode 
Process Scale 
Process Data Units 
Pressure Target 
11 Coil Temp Control Mode 


Coil Temp Setpoint 
Case Temp Control Mode 
Case Temp Setpoint 
Bearing Temp Control Mode 
Bearing Temp Setpoint 


Vent Valve Config 


All of the elemental components listed above follow standard CIP Data Encoding as specified 
in Appendix C. 


Any component that is unsupported shall be set to 0. 
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6-36.7 


I/O Assembly Instance Component Mapping 


The following table indicates the I/O assembly Data attribute mapping for this device. 


Table 6-36.6 I/O Assembly Data Mapping 


Class 


Instance 


Data Component Object Name ID ID Attribute Name | Attrib Data Type 
Exception Status | S-Device Supervisor 30hnex | 1 Exception Status | 12 BYTE 
Pump On Status _| Discrete Input Point O8re, | 1 Value 3 BOOL 
Pump On Discrete Output Point O9nex | 1 Value 3 BOOL 
Pump Speed AC/DC Drive 2Anex |1 SpeedActual 7 INT 
Speed Status AC/DC Drive 2Anex | 1 Speed Status 42 BYTE 
Speed Control AC/DC Drive 2Anex |1 Speed Control 41 BYTE 
Speed Target AC/DC Drive 2Anex | 1 SpeedRef 8 INT 
Current AC/DC Drive 2Anex | 1 CurrentActual 9 INT 
Inlet Pressure AC/DC Drive 2Anex | 1 ProcessActual 13 INT 
Speed Scale AC/DC Drive 2Anex |1 SpeedScale 22 SINT 
Speed Data Units | AC/DC Drive 2Anex | 1 SpeedActual 43 ENGUNITS 
Data Units 
High Speed Limit | AC/DC Drive 2Anex | 1 HighSpeed- 21 UINT 
Limit 
Speed Target Data | AC/DC Drive 2Anex |1 SpeedRef Data | 44 ENGUNITS 
Units Units 
Time Scale AC/DC Drive 2Anex | 1 TimeScale 28 SINT 
Acceleration Time | AC/DC Drive 2Anex |1 AccelTime 18 UINT 
Deceleration Time | AC/DC Drive 2Anex | 1 DecelTime 19 UINT 
Overload Time AC/DC Drive 2Anex | 1 Speed Trip Time | 38 UINT 
Current Scale AC/DC Drive 2Anex | 1 CurrnetScale 23 SINT 
Current Limit AC/DC Drive 2Anex |1 CurrentLimit 10 INT 
Drive Mode AC/DC Drive 2Anex | 1 DriveMode 6 USINT 
Process Scale AC/DC Drive 2Anex | 1 ProcessScale 25 SINT 
Process Data Units | AC/DC Drive 2Anex | 1 Process Data 45 ENGUNITS 
Units 
Pressure Target AC/DC Drive 2Anex |1 ProcessRef 14 INT 
Coil Temp S-Analog Sensor 3lhex |1 Value 6 INT 
Coil Temp Control | S-Single Stage Controller | 33,., | 1 Control Mode 5 USINT 
Mode 
Coil Temp Setpoint | S-Single Stage Controller 33hex 1 Setpoint 6 INT 
Case Temp Control | S-Single Stage Controller Sonex || 2 Control Mode 5 USINT 
Mode 
Case Temp Setpoint | S-Single Stage Controller | 33h | 2 Setpoint 6 INT 
Bearing Temp S-Single Stage Controller | 33, | 3 Control Mode 5 USINT 
Control Mode 
Bearing Temp S-Single Stage Controller | 33h. | 3 Setpoint 6 INT 
Setpoint 
Vent Valve Config | Register O7nex | 1 Data 4 ARRAY of BOOL 
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6-36.8 Object Limitations and Specific Definitions 


This section describes limitations and specific definitions applicable to the listed objects of this 
device profile when these objects are applied in this type of device. 


6-36.8.1 S-Device Supervisor 
The following attribute limitations apply: 


Table 6-36.7 Device Type Attribute Limitations 


Attribute Requirements 


Device Type Set to "Turbo Pump" for the Turbomolecular Vacuum Pump Device 


The following table specifies the data attribute bit mapping for the Exception Detail bytes for 
this device. For more descriptive information, see the definition of the S-Device Supervisor 
Object Class. 


Any Exception Bit not supported shall default to 0. 


Table 6-36.8 Attribute Bit Mapping 


Data Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
Component 


Turbo Pump 0 0 0 0 0 0 1 0 
Device 
Exception Detail 
Size 


Turbo Pump Excess Startup Speed Over- Over- Mains TMS CNT 
Device Vibration | Timeout Trip current * | speed* | Failure * | Failure Failure 
Exception Detail 
Byte 0 
Turbo Pump 0 Inter- Bearing Cable | Controller] Bearing Case Motor 
Device locked Fault Fault * | Overheat | Overheat | Overheat Coil 
Exception Detail Overheat 
Byte 1 


Manufacturer 0 0 0 0 0 0 0 1s 
Exception Detail 
Size ** 


Manufacturer 8 Bits defined by Manufacturer 
Exception Detail 
ok 


* Exception Detail Alarm only; not supported in Exception Detail Warning 


** This example shows a one-byte manufacturer exception detail, but there may be zero or many bytes defined 
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Table 6-36.9 Exception Detail Bit Description 


Exception Description 
CNT Failure Controller Unit failure 
TMS Failure Temperature Management System failure 
Mains Failure Insufficient power (power failure or incorrect connection) 
Over-speed Pump failure 
Over-current Pump failure 
Speed Trip Pump overload typically sensed by reduced speed exceeding the Speed Trip 
Time 
Startup Timeout Normal speed from startup not obtained within specified AccelTime 
Excess Vibration Physical fault 
Motor Coil Overheat Thermal fault 
Case Overheat Thermal fault 
Bearing Overheat Thermal fault 
Controller Overheat Thermal fault 
Cable Fault Controller Unit to Pump interconnection cable is misconnected or disconnected 
Bearing Fault Damaged bearing requires service 
Interlocked Normal pump operation is not possible due to an external interlock signal 


6-36.8.2 Register Object 


6-36.8.2.1 Object Instance Number Assignment 


The following instance numbering shall apply: 


Table 6-36.10 Instance Numbers 


1 Vent Valve Configuration 


Table 6-36.11 Instance 1 — Output — Vent Valve Configuration Data 


1 Valve 8 Valve 7 Valve 6 Valve 5 


The following values are defined for each Valve listed above. 


Table 6-36.12 Values Defined For Each Valve 


Valve n Config Description 
Nibble Value 
0 Disabled / No Vent 
1 Pump Controlled Vent 
2 Vendor Specified Vent 
3 Reserved by DeviceNet 
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6-36.8.3. Discrete Input Point Object 


6-36.8.3.1 Object Instance Number Assignment 


The following instance numbering shall apply: 


Table 6-36.13 Instance Numbering 


1 Yes Pump On/Off 0 = Pump Off 
1 = Pump On AND Speed > 0 


6-36.8.3.2 Attribute Definitions 


The following attribute limitations apply: 


Table 6-36.14 Attribute Limitations 


Attribute Limitation 


Off_On Cycles Supported with Get Only Access Rule 


The value of Discrete Input Point Object instance 1, Value attribute (ID 3) is received from 
AC/DC Drive Object instance ID 1, Speed Status attribute (ID 39) Bit 0 (Running). 


6-36.8.4 Discrete Output Point Object 


6-36.8.4.1 Object Instance Number Assignment 


The following instance numbering shall apply: 


Table 6-36.15 Instance Numbering 


Instance Description of the Value Attribute 


1 Yes Pump On/Off 0 = Pump Off 
1 = Pump On 
2 No TMS Function or 0 = TMS or Heater Off 
Bakeout Heater * 1 = TMS or Heater On 
3 No Purge Gas Valve 0 = Valve Closed 
1 = Valve Open 


* TMS or Bakeout Heater is based on Pump Configuration 


The value of Discrete Output Point Object instance 1, Value attribute (ID 3) is sent to AC/DC 
Drive Object instance ID 1, Speed Control attribute (ID 38) Bit 0 (Run Request). 
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AC/DC Drive Object 


Attribute Limitations 


The following table lists the attributes of the AC/DC Drive Object, Instance 1, and specifies 
any special definitions for this device profile. Attributes implemented as specified are not 


shown in this table. 


Table 6-36.16 AC/DC Drive Object, Instance 1 Attributes 


NetRef Optional Support 
Access Rule = Get 
NetProc Optional Support 
Access Rule = Get 
DriveMode Supported Values = 
0 = Vendor Specified 
2 = Closed Loop Speed 
4 = Process Control 
SpeedActual Units Specified by Speed Data 
Units attribute value 
SpeedRef Units Specified by Speed Data 
Units attribute value 
ProcessActual Units Specified by Process Data 
Units attribute value 
ProcessRef Units Specified by Process Data 
Units attribute value 
OutputVoltage Not Supported 
RefFromNet Optional Support 
Access Rule = Get 
ProcFromNet Optional Support 


Access Rule = Get 


Speed Trip Time As defined 


Limited to: 


Speed Status 


SpeedActual Data 
Units 


Units of Frequency (Volume 1, 


Appendix D) as well as the 
following special vales: 


1007(Hex) = % of Target 


0800(Hex) = % of MaxRated 


Limited to: 


SpeedRef Data Units 


Units of Frequency (Volume 1, 
Appendix D) 


Process Data Units Limited to Units of Pressure 
(Volume 1, Appendix D) 


* Vendor may impose further limitations. 
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1309 hex 
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Definition 
0 = Speed Control NOT by Net 
1 = Speed Control by Net 


0 = Process Control NOT by 
Net 
1 = Process Control by Net 


Value derived from Gauge at 
Pump Inlet 


0 = Local Speed Reference 
1 = Net Speed Reference 


0 = Local Process Reference 
1 = Net Process Reference 


a Speed Trip Condition results 
in the setting of the Speed Trip 
bit of the S-Device Supervisor 
Exception Detail. 


If attribute not supported the 
value of "RPM" shall be 
specified. 


If attribute not supported the 
value of "RPM" shall be 
specified. 


If attribute not supported the 
value of "Pa" shall be specified. 
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6-36.8.5.2 Behavior 
The value of Discrete Input Point Object instance 1, Value attribute (ID 3) is received from 
AC/DC Drive Object instance ID 1, Speed Status attribute (ID 39) Bit 0 (Running). 


The value of Discrete Output Point Object instance 1, Value attribute (ID 3) is sent to AC/DC 
Drive Object instance ID 1, Speed Control attribute (ID 38) Bit 0 (Run Request). 


The behavior associated with the Speed Trip Condition and the Acceleration Timeout shall be 
that the respective bit is set in the S-Device Supervisor exception detail attribute to indicate the 
condition. Further, based upon the vendor's declaration of these bits as Critical or Non- 
Critical, the behavior of the Turbo shall be affected as specified by the vendor's documentation. 
Typically, either of these conditions will be considered Critical and cause the Turbo to 
shutdown. 


6-36.8.6 S-Analog Sensor Object 


6-36.8.6.1 Object Instance Number Assignment 


The following instance numbering shall apply: 


Table 6-36.17 Instance Number Assignments 


Instance Description 
1 Motor Coil Temperature 
2 Case Temperature 
3 Bearing Temperature 
4 Controller Unit Temperature 
5 TMS Temperature 


6-36.8.6.2 Attribute Definitions 


The following attribute limitations apply to all instances: 


Table 6-36.18 Attribute Limitations 


Attribute Limitation 
Data Type Supported Value = {INT} 
Data Units Supported Value = {decidegrees Centigrade} 


Alarm Trip Points and Warning Trip Points shall be supported and shall be limited to GET only 
Access if the corresponding components are supported in the Exception Detail Alarm and 
Exception Detail Warning attributes defined for the S-Device Supervisor object. 
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6-36.8.7. S-Single Stage Controller Object 
6-36.8.7.1 Object Instance Number Assignment 
The following instance numbering shall apply: 


Table 6-36.19 Instance Number Assignment 


Instance Description 
1 TMS Control 


6-36.8.7.2 Attribute Definitions 


The following attribute limitations apply to all instances: 


Table 6-36.20 Attribute Limitations 


Attribute Limitation 
Data Type Supported Values = {INT} 
Data Units Supported Values = {decidegrees Centigrade} 
Control Mode Supported Values = {Normal, & Off} * 


* The S-Single Stage Controller object instance supports only the Normal and Off control modes as defined by 
the object specification. The Normal control mode behaves as defined. However, the Off control mode 
behaves in a manner that is vendor specific. The Vendor shall specify the behavior of the object in the Off 
control mode. Examples include: maximum cooling, no cooling, or default cooling. 


Alarm Trip Points and Warning Trip Points shall be supported and shall be limited to GET only 
Access if the corresponding components are supported in the Exception Detail Alarm and 
Exception Detail Warning attributes defined for the S-Device Supervisor object. 


6-36.9 Defining Device Configuration 


Public access to the S-Device Supervisor by the Message Router must be supported for 
configuration of this device type. 
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6-37 Residual Gas Analyzer Device 
Device Type: 1E hex 


A Residual Gas Analyzer (RGA) is a device that measures partial pressures of gasses. The 
device is composed of a filament, which is controlled through the S-Device Supervisor object, 
and a partial pressure measurement apparatus, which is controlled by S-Partial Pressure objects. 


The S-Partial Pressure objects are instantiated (created), one each, for every Atomic Mass Unit 
(AMU) to be scanned. Each instance is configured for the measurement of partial pressure or 
range of partial pressures. Class Level services are supported for requesting scan lists of partial 
pressures. 


6-37.1 Object Model 
The Object Model in Figure 6-37.2 represents a Residual Gas Analyzer Device. The table 
below indicates: 


e the object classes present in this device 
e whether or not the class is required 
e the number of instances present in each class 


Table 6-37.1 Objects Present in a Residual Gas Analyzer Device 


Object Class Optional/Required # of Instances 
CIP Common Required Objects Required See Section 6-2.1 
Assembly Required at least 1 Input and 1 Output 
S-Device Supervisor Required 1 


S-Partial Pressure Required at least 1 * 
S-Analog Sensor Optional 1 
Discrete Input Point Optional 1 


Discrete Output Point Optional lor2 


* The number of instances is determined by the total number of AMU values or gas species 
supported per scan. Generally, this number will be 100 - 800. 


6-37.2 Class Subclasses 


Each class level subclass defines a unique meaning for an overlapping range of class attribute 
IDs and/or class service IDs. The range for subclass definitions begins at ID 96 and numbers 
downward for attributes, and ID 63;., and numbers downward for services. The subclass for a 
given class is identified by the value of its Subclass class attribute. 


There are no Class Level Subclasses specified for the RGA device. 


6-37.3. Instance Subclasses 


Each instance level subclass defines a unique meaning for an overlapping range of instance 
attribute IDs and/or instance service IDs. The range for subclass definitions begins at ID 96 
and numbers downward for attributes, and ID 63;., and numbers downward for services. The 
subclass for a given instance is identified by the value of its Subclass instance attribute. 
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There are no Instance Level Subclasses specified for the RGA device. 


Figure 6-37.2 Object Model for the RGA Device 
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6-37.4 How Objects Affect Behavior 


Table 6-37.3 Object Affect on Behavior 


Object Effect on behavior 


Identity Supports the Reset service. Upon receipt of a Reset Service request, a similar 
request is passed to the S-Device Supervisor. 


CIP Common Required See Section 6-2.2 for details. 


Assembly Defines input/output and configuration data format 


S-Device Supervisor Supports the Stop, Start, Reset, Abort, Recover and Perform_Diagnostic 
services for ALL Application Objects in the device and consolidates the 
Exception Conditions and Application Objects’ Status 


S-Partial Pressure Provides the means by which Partial Pressures are selected, measured and 
reported. 
S-Analog Sensor If present, the value from this measurement may interlock the device such that 


it may not be able to turn on for pressures are that are considered by the 
manufacturer to be too high 


Discrete Input Point No effect on the device 


Discrete Output Point No effect on the device 


6-37.5 Defining Object Interfaces 


Table 6-37.4 Object Interfaces 


Object Interface 
CIP Common Required See Section 6-2.3 for details. 
Assembly 1/O Connection or Message Router 
S-Device Supervisor Assembly or Message Router 
S-Partial Pressure Assembly or Message Router 
S-Analog Sensor Assembly or Message Router 
Discrete Input Point Assembly or Message Router 
Discrete Output Point Assembly or Message Router 


6-37.6 I/O Assembly Instances 


The manufacturer of an RGA Device must specify which Assembly instances are supported by 
the device as well as the maximum number of S-Partial Pressure instances. For devices 
configured with fewer Partial Pressures than the number specified in a given input assembly, 
the missing Data Components of that assembly will be set to zero (0). Note that for the purpose 
of bandwidth optimization, I/O connections to such assemblies, where less than the included 
number of instances are valid, the I/O connection's Produced_Connection_Size attribute value 
can be set accordingly. 


Note that the member lists for Partial Pressures and Status attributes are arranged according to 
Object Instance ID. Even if a given S-Partial Pressure Instance is disabled, it will be included 
in the I/O Data. Therefore, care must be taken by the user to specify AMU values for each 
instance in order of desirability, not necessarily AMU value. 


The following table identifies the I/O assembly instances. 
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Table 6-37.5 I/O Assembly Instances 


Instance | Required | Type | Byte | Bit 7 | Bit 6 | Bit5 | Bit 4 | Bit 3 | Bit 2 | Bit 1 | Bit 0 


1 Y Output 0 Filaments On/Off 
(default) 

2 Y Input 0 Exception Status 
(default) 


Time 


Partial Pressure 1 


3 Y Input Exception Status 
Status 1 
4 Y Input Exception Status 


Time 


Partial Pressure 1 


Partial Pressure 2 


Partial Pressure 3 


Partial Pressure 4 


Partial Pressure 5 


Partial Pressure 6 


Partial Pressure 7 


Partial Pressure 8 


Partial Pressure 9 
Partial Pressure 10 
5 Y Input Exception Status 


Status 1 


Status 2 


Status 3 


Status 4 
Status 5 


Status 6 


Status 7 


Status 8 
Status 9 
Status 10 


Exception Status 


Time 


Partial Pressure 1 


Partial Pressure 2 


Partial Pressure 3 


403-406 Partial Pressure 100 
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Instance | Required | Type | Byte Bit 7 | Bit 6 | Bit 5 | Bit 4 | Bit 3 | Bit 2 | Bit 1 | Bit 0 


7 N Input 0 Exception Status 
1 Status 1 
2 Status 2 
3 Status 3 


Status 100 


Exception Status 


Time 


Partial Pressure 1 


Partial Pressure 2 


Partial Pressure 3 


Partial Pressure 800 


Exception Status 


Status 1 


Status 2 


Status 3 


Status 800 


All of the elemental components listed above follow standard CIP Data Encoding as specified 
in Appendix C. 


6-37.6.1 I/O Assembly Instance Component Formats 


All of the elemental components listed above follow standard CIP Data Encoding as specified 
in Appendix C. The encoding order for all data is Low Byte first. All members are LSB 
aligned and end on Byte boundaries. That is, upper bits are stuffed with 0 as needed to fill to 
the next byte. 
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6-37.6.2 I/O Assembly Instance Component Mapping 
The following table indicates the I/O assembly Data attribute mapping for this device. 


Table 6-37.6 I/O Assembly Data Mapping 


Data Component Class | Instance | Attribute | Attribute | Member | Data 
Object Name Index 
Name ID ID Name ID Type 
Filaments On/Off | s-partial Pressure | 38hex | 0** | Filament 32 N.A. | BYTE 
Control 
Exception Status | s_Device 30hex 1 Exception 12 N.A. BYTE 
Supervisor Status 
Time S-Device 30hex 1 |Time 17 N.A. | DATE_ 
Supervisor AND _ 
TIME 
Partial Pressurei*|s_partial Pressure | 38,0, | i* _ | Partial 13 N.A. | REAL 
Pressure 
Status i * S-Partial Pressure | 38,0, | i* | Status 7 N.A. | BYTE 


* The assignment of the Instance ID is a one-for-one mapping to the ordering of the members of the Input 
Assemblies in the above table. i.e., Partial Pressure 1 is the Partial Pressure from the S-Partial Pressure 
Object Instance 1. Therefore, the user must configure each instance of the S-Partial Pressure object for the 
desired Partial Pressure in the order they are to appear in the Input Assembly member list. 

** Instance 0 corresponds to the Class Level 


6-37.7. Object Limitations and Specific Definitions 


This section describes limitations and specific definitions applicable to the listed objects of this 
device profile when these objects are applied in this type of device. 


Table 6-37.7 S-Device Supervisor 


Attribute Requirements 


Device Type Set to "RGA" for Residual Gas Analyzer Device 


The following table specifies the data attribute bit mapping for the Device Exception Detail 
bytes for this device. For more descriptive information, see the definition of the S-Device 
Supervisor Object Class. 


Any Exception Bit not supported shall default to 0. Note that this profile allows for only one 
byte of manufacturer specific exception detail. 
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Table 6-37.8 Attribute Bit Mapping 


Data Component Bit 7 Bit6 | Bit5S | Bit4 Bit 3 Bit 2 Bit 1 Bit 0 
Name 
RGA Device Exception 0 0 0 0 0 0 1 0 
Detail Size 
RGA Device Exception 0 0 0 0 0 Partial Partial Reading 
Detail Byte 0 Pressure | Pressure Invalid 
High Low 
RGA Device Exception 0 0 0 0 Filament 4| Filament 3 | Filament 2} Filament 1 
Detail Byte 1 Fault Fault Fault Fault 
Manufacturer Exception 0 0 0 0 0 0 0 1 
Detail Size * 
Manufacturer Exception 8 Bits defined by Manufacturer 
Detail * 


* This example shows a one-byte manufacturer exception detail, but there may be zero or many bytes defined 


Table 6-37.9 S-Partial Pressure Object Class 


Attribute Additions / Limitation Requirements 


6-37.7.1 S-Analog Sensor Object 
6-37.7.1.1 Class 


An RGA device may be able to support an external Capacitance Manometer. However, an 
implementation may, or may not, include this connection. Therefore, devices that support this 
object shall support the Class Level services Create and Delete for the S-Analog Sensor object. 


6-37.7.1.2 Instance 


Instance ID 1 (one) is used to interface to an external Capacitance Manometer. 


6-37.7.1.3 Attribute Definitions 


The following attribute limitations apply: 


Table 6-37.10 Attribute Limitations 


Attribute Requirements 


Gain It is assumed that the external Capacitance Shall be set to Full Scale (in 
Manometer is calibrated to yield a linear output Torr) of the externally 
from 0-10 Volts corresponding to Zero-Full Scale connected Capacitance 
reading. Manometer divided by 10 
(ten). 
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6-37.7.2. Discrete Input Point Object Instance 


Instance ID 1 (one) is used to interface to an external Turbomolecular Pump. Specifically, this 
input is connected to the pump's At Speed indicator. Thus, the Value attribute indicates 
whether the pump is operating at the specified pumping speed. 


0 = False / 1 = True. 


6-37.7.3 Discrete Output Point Object Instance 


6-37.7.3.1 Object Instance Number Assignment 


The following instance numbering limitations apply: 


Table 6-37.11 Instance Numbering Limitations 


Instance Description 
1 Valve Open - connected externally to a Pump Isolation Valve. Used to command the 
valve to open or close. 
0 = Close / 1 = Open 
2 Turbo Pump On - connected externally to a Turbomolecular Pump. Used to command 


the pump on or off. 
0=Off/1=On 


6-37.8 Defining Device Configuration 


Public access to the S-Device Supervisor and S-Partial Pressure Objects by the Message Router 
must be supported for configuration of this device type. There is no Parameter Object defined 
for access to the device type’s configuration parameters. 
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6-38 DC Power Generator Device 


Device Type: 1F hex 


A DC Power Generator is a device that converts AC utility power to regulated DC power. It 
uses sensors to monitor the output, and a controller, which closes the loop with a setpoint such 
that the output is controlled to the setpoint. The setpoint value can be a voltage, current or 
power level. 


6-38.1 Object Model 
The Object Model in Figure 6-38.4 represents a DC Power Generator Device. The table below 
indicates: 


e the object classes present in this device 
e whether or not the class is required 
e the number of instances present in each class 


Table 6-38.1 Objects Present in a DC Power Generator Device 


Object Class Optional/Required # of Instances 
CIP Common Required Objects See Section 6-2.1 
Assembly Required at least 5 Input and 
5 Output 
S-Device Supervisor Required 1 
S-Analog Sensor Required at least 1 


as many as 6 


S-Analog Actuator Required il 
S-Single Stage Controller Required 1-3 
Selection Required t 
Register Required 2 


6-38.2 Subclasses 


Some of the object classes used by this profile define class and/or instance level subclasses. 
Each subclass defines a unique meaning for an overlapping range of attribute IDs and/or 
service IDs. The range for subclass definitions begins at ID 96 and numbers downward for 
attributes, and ID 63h, and numbers downward for services. The subclass in use, for a given 
object class or instance, by the device is identified by the value of its Subclass attribute. The 
following tables specify the subclass ID and corresponding object class and/or instance ID for 
this profile. 
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Table 6-38.2 S-Device Supervisor Object Subclass 


Object Subclass Name Subclass ID | Required Function Restrictions 
Instance (Attribute 
ID 99 Value) 
1 Power Generator 01 Required Device None 
Management 


Table 6-38.3 S-Single Stage Controller Object Subclasses 


Object Subclass Name Subclass ID | Required Function Restrictions 
Instance (Attribute 
ID 99 Value) 
1 DC Generator 02 Conditional * | Power Data Units = Watts or 
Regulation | milliWatts 
2 DC Generator 02 Conditional * | Voltage Data Units = Volts 
Regulation 
3 DC Generator 02 Conditional * | Current Data Units = milliAmps 
Regulation 


* At least one of these instances shall be supported 
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Figure 6-38.4 Object Model for the DC Power Generator Device 
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6-38.3. How Objects Affect Behavior 


Table 6-38.5 Object Affect on Behavior 


Object Effect on behavior 


Identity Supports the Reset service. Upon receipt of a Reset Service 
Request of any Type, the Identity Object sends a Reset Service 
Request to the S-Device Supervisor. 


CIP Common Required See Section 6-2.2 for details. 


Assembly Defines input/output and configuration data format. 


S-Device Supervisor Supports the Stop, Start, Reset, Abort, Recover and 
Perform_Diagnostic services for ALL Application Objects in 
the device and consolidates the Exception Conditions and 
Application Objects’ Status. 


This object behaves differently from the Identity Object in that 
the S-Device Supervisor object provides a single point of access 
to the Application Objects only; it does not effect the 
DeviceNet specific objects (i.e., Identity, DeviceNet, 
Connection, etc.). 


S-Analog Sensor Provides sensed measurements and feeds process variables to 
the S-Single Stage Controllers. 

S-Single Stage Controller The active instance feeds the control variable to the S-Analog 
Actuator whereby regulating the output as specified. 

S-Analog Actuator Operates the Power Generator output drive circuitry. 

Selection Activates an instance of the S-Single Stage Controller class and 


feeds it the Setpoint variable. 
Register Instance 1 - No effect. 


Instance 2 - The transition of any interlock bit from 0 to 1 
causes an internally generated Stop Service Request to the S- 
Device Supervisor object instance. Also, any interlock bit in the 
1 state shall prevent the S-Device Supervisor object from the 
EXECUTING state. See Register section below. 


6-38.4 Defining Object Interfaces 


Table 6-38.6 Object Interfaces 


Object Interface 
CIP Common Required See Section 6-2.3 for details. 
Assembly I/O Connection or Message Router 
S-Device Supervisor Assembly or Message Router 
S-Analog Sensor Assembly or Message Router 
S-Analog Actuator Assembly or Message Router 
S-Single Stage Controller | Assembly or Message Router 
Selection Assembly or Message Router 
Register Assembly or Message Router 
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6-38.5 I/O Assembly Instances 


The following table identifies the I/O assembly instances. The manufacturer must specify 
which Assembly instances are supported by the device. 


Any element not supported must be set to zero (0). 


Table 6-38.7 I/O Assembly Instances 


Instance | Required | Type | Byte | Bit7 | Bit6é | BitS | Bit4 | Bit3 | Bit2 | Bit1 | Bito 
1 Y Output |0 Power Out 12 (low byte) 
(Default) 1 0 0 0 0 Power Out 12 (high nibble) 
2-3 | Power Ramp 
4 0 0 0 0 0 0 0 On 
2 Y Input 0 Power In 12 (low byte) 
(Default) 1 0 0 0 0 Power In 12 (high nibble) 
2 Voltage In 12 (low byte) 
3 0 0 0 0 Voltage In 12 (high nibble) 
4 Current In 12 (low byte) 
5 0 0 0 0 Current In 12 (high nibble) 
6-7 | Power Ramp 
8 Op Status 
3 Y Output |0 0 0 0 0 0 0 0 On 
4 N Output {0-3 | Power Limit 
4-7 | Voltage Limit 
8-11 | Current Limit 
5 Y Output |O-1 | Regulation Select 
2-5 | Setpoint 
6-7 | Power Ramp 
8 0 0 0 0 0 0 0 On 
6 N Output {0-1 | Regulation Select 
2-5 | Setpoint 
6 0 0 0 0 0 0 0 On 
7 Y Output |0-3 | Power Out 
4 0 0 0 0 0 0 0 On 
8 Y Output |0-3 | Power Out 
4-5 | Power Ramp 
6 0 0 0 0 0 0 0 On 
9 Y Input 0 Ex Status 
1-4 | Power In 
5-8 | Voltage In 
9-12 | Current In 
10 N Input 0 Ex Status 
1-4 |Energy In 
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Instance | Required | Type | Byte | Bit7 | Bit6é | BitS | Bit4 | Bit3 | Bit2 | Bit1 | Bito 
11 N Input 0 Ex Status 

1-4 | Power In 

5-8 | Voltage In 

9-12 | Current In 

13 - 16) Energy In 
12 N Input 0 Ex Status 

1-2 |W Temp 

3-4 |DTemp 
13 N Output |0-3 | Voltage Out 

4 0 0 0 0 0 0 0 On 
14 N Output |0-3 | Voltage Out 

4-5 | Voltage Ramp 

6 0 0 0 0 0 0 0 On 
15 N Output |O-3 | Current Out 

4 0 0 0 0 0 0 0 On 
16 N Output }O-3 | Current Out 

4-5 |Current Ramp 

6 0 0 0 0 0 0 0 On 
17 N Input 0 Ex Status 

1-4 | Power In 
18 N Input 0 Ex Status 

1-4 | Voltage In 
19 N Input 0 Ex Status 

1-4 |Current In 
20 Y Input 0 Ex Status 
21 Y Input 0 Exception Detail Alarm 0 (size, common = 2) 

1 Exception Detail Alarm 1 (common 0) 

2 Exception Detail Alarm 2 (common 1) 

3 Exception Detail Alarm 3 (size, device = 2) 

4 Exception Detail Alarm 4 (device 0) 

5 Exception Detail Alarm 5 (device 1) 

6 Exception Detail Alarm 6 (size, manufacturer = 1) 

7 Exception Detail Alarm 7 (manufacturer 0) 
22 Y Input 0 Exception Detail Warning 0 (size, common = 2) 

1 Exception Detail Warning 1 (common 0) 

2 Exception Detail Warning 2 (common 1) 

3 Exception Detail Warning 3 (size, device = 2) 

4 Exception Detail Warning 4 (device 0) 

5 Exception Detail Warning 5 (device 1) 

6 Exception Detail Warning 6 (size, manufacturer = 1) 

7 Exception Detail Warning 7 (manufacturer 0) 
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Instance | Required | Type | Byte | Bit7 | Bit6é | BitS | Bit4 | Bit3 | Bit2 | Bit1 | Bito 


23 N Input Ex Status 


Exception Detail Alarm 0 (size, common = 2) 


Exception Detail Alarm 1 (common 0) 


Exception Detail Alarm 2 (common 1) 


Exception Detail Alarm 3 (size, device = 2) 


Exception Detail Alarm 5 (device 1) 


Exception Detail Alarm 6 (size, manufacturer = 1) 


Exception Detail Alarm 7 (manufacturer 0) 


0 
1 
2 
3 
4 
5 Exception Detail Alarm 4 (device 0) 
6 
7 
8 
9 


Exception Detail Warning 0 (size, common = 2) 


10 Exception Detail Warning 1 (common 0) 


11 Exception Detail Warning 2 (common 1) 


12 Exception Detail Warning 3 (size, device = 2) 


13 Exception Detail Warning 4 (device 0) 


14 Exception Detail Warning 5 (device 1) 


15 Exception Detail Warning 6 (size, manufacturer = 1) 


16 Exception Detail Warning 7 (manufacturer 0) 


24 N Input 
25 N Input 


Op Status 


Interlock Status (low byte) 


0 

0 

1 Interlock Status (high byte) 
26 N Input 0 Ex Status 

1 

2 

3 


Op Status 


Interlock Status (low byte) 


Interlock Status (high bytes) 


6-38.5.1 I/O Assembly Instance Component Formats 


All of the elemental components listed above follow standard CIP Data Encoding as specified 
in Appendix C. The encoding order for all data is Low Byte first. All members are LSB 
aligned and end on Byte boundaries. That is, upper bits shall be stuffed with 0 as needed to fill 
to the next byte. 
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6-38.5.2 


I/O Assembly Instance Component Mapping 


Each of the S-Analog Sensor, S-Analog Actuator and S-Single Stage Controller object 


definitions specify a behavior that modifies the Data Type of certain attributes based upon the 


first valid I/O connection established to an Assembly Object instance. See these object 
definitions for more detail. 


The following table indicates the I/O assembly Data attribute mapping for this device. 


Table 6-38.8 I/O Assembly Data Mapping 


4 Class | Instance 4 Attribute | Data 
Data Component Object Name ID ID Attribute Name ID Type 
Power Out 12 | s.single Stage 33hex 1 | Setpoint 6 UINT 
Controller 
PowerIn12 | s. Analog Sensor Stas 1 ‘| Value 6 UINT 
Voltage In12 | s-Analog Sensor Sleek 2 | Value 6 UINT 
Current In12 | s. analog Sensor Sia. 3 | Value 6 UINT 
Power Ramp | S-Single Stage Bonus 1 —_|Ramp Rate 96 UINT 
Controller Increment 
Voltage Ramp _| s-single Stage BB nex 2 | Ramp Rate 96 UINT 
Controller Increment 
Current Ramp | s-single Stage cee 3 | Ramp Rate 96 UINT 
Controller Increment 
On S-Device Supervisor} 30hex 1 Output Power 96 BOOL 
Enable 
Op Status Register OF hes 1 | Data 4 ARRAY 
of 8 
BITS 
Power Limit —_| s-Single Stage Sade 1 | Output Limit 86 DINT 
Controller 
Voltage Limit | s-single Stage Bois 2 | Output Limit 86 DINT 
Controller 
Current Limit | s-single Stage 33hex 3 | Output Limit 86 DINT 
Controller 
Regulation Select | selection 2Ehex 1 destination_used 14 UINT 
Setpoint Selection OB iG: 1 | input_data_value 15 DINT 
Power Out S-Single Stage 33hex 1 Setpoint 6 DINT 
Controller 
Voltage Out —_| s-single Stage coe 2 | Setpoint 6 DINT 
Controller 
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f Class | Instance : Attribute | Data 
Data Component Object Name ID ID Attribute Name ID Type 
Current Out | s-single Stage 33 hax 3 | Setpoint 6 DINT 
Controller 
Power In S-Analog Sensor Stay 1 ‘| Value 6 DINT 
Voltage In S-Analog Sensor 3lhex 2. | Value 6 DINT 
Current In S-Analog Sensor 31hex 3 | Value 6 DINT 
Energy In S-Analog Sensor Slide 4 | Value 6 DINT 
W Temp S-Analog Sensor Blade 5 | Value 6 INT 
D Temp S-Analog Sensor Blikex 6 | Value 6 INT 
Interlock Status | Register O7hex 2 ‘| Data 4 ARRAY 
of 16 
BITS 
Ex Status S-Device Supervisor] 30pox 1 | Exception Status 12 BYTE 
Exception Alarm | s-Device Supervisor | 30hex 1 Exception Detail 13 STRUCT 
Alarm 
Exception Warning | s_Device Supervisor | 30hex 1 Exception Detail 14 STRUCT 
Warning 


6-38.6 Object Limitations and Specific Definitions 


This section describes limitations and specific definitions applicable to the listed objects of this 
device profile when these objects are applied in this type of device. 


6-38.6.1 S-Device Supervisor 


The following attribute limitations apply: 


Table 6-38.9 Device Type Attribute Limitation 


Attribute Requirements 


Device Type Set to "DCG" for DC Power Generator Device 


The following table specifies the data attribute bit mapping for the Device Exception Detail 
bytes for this device. For more descriptive information, see the definition of the S-Device 
Supervisor Object Class. 
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Any Exception Bit not supported shall default to 0. Note that this profile allows for only one 
byte of manufacturer specific exception detail. 


Table 6-38.10 Data Attribute Bit Mapping 


Data Component Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
Device Exception 0 0 0 0 0 0 1 0 
Detail Size 
Device Exception | Reserved Input Input End of Cooling Device | Interlock | Control 
Detail 0 Power Power Target Failure Temp Open Circuit 
Byte 0 VLow | V High* Life * High Fault 
Byte 1 Reserved | Reserved | Reserved | Reserved | Reserved | Arc Limit | Process | Regulation 
0 0 0 0 0 Ey V Low 
Manufacturer 0 0 0 0 0 0 0 1 
Exception Detail 
Size 


Manufacturer | 8 Bits defined by Manufacturer 
Exception Detail 
Byte 0 


* Only used in the Warning Exception Detail, this bit is always = 0 in the Alarm Exception Detail 


6-38.6.2. S-Analog Sensor Object Instances 


Table 6-38.11 Object Instances 


Object 
Instance Function Required Limitations and Specific Definitions 
ID 

1 Output Power Required | Supported Data Type and Data Units pairs: 
DINT / Watts; 
DINT / milliWatts 
UINT / % * 

2 Output Voltage Optional | Default Full Scale = 1.0 KV 
Supported Data Type and Data Units pairs: 
DINT / Volts (rms); 
UINT / % * 

3 Output Current Optional | Supported Data Type and Data Units pairs: 
DINT / milliAmps (rms); 
UINT / % * 

4 Delivered Energy Optional | DINT / Joules 

since Output Power 
was last turned On 

5 Cooling Water Temp | Optional |INT/°C 
Resolution = 1 Degree 

6 Device Temp Optional |INT/°C 
Resolution = 1 Degree 


* Range = 0 - 4095 corresponding to 0 - 100% 
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6-38.6.3 S-Analog Actuator Object Instances 


Table 6-38.12 Object Instances 


Object 
Instance Function Required Limitations and Specific Definitions 
ID 
1 Output Power Required | Supported Data Type and Data Units pairs: 
DINT / Watts; 
DINT / milliWatts 
UINT / % * 


* Range = 0 - 4095 corresponding to 0 - 100% 


6-38.6.4 S-Single Stage Controller Object Instances 


Table 6-38.13 Object Instances 


Object 
Instance Function Required Limitations and Specific Definitions 
ID 
1 Output Power Optional | Supported Data Type and Data Units pairs: 
Regulation DINT / Watts; 
DINT / milliWatts; 
UINT / % * 
2 Output Voltage Optional | Supported Data Type and Data Units pairs: 
Regulation DINT / Volts (rms); 
UINT / % * 
3 Output Current Optional | Supported Data Type and Data Units pairs: 
Regulation DINT / milliAmps (rms); 
UINT / % * 


* Range = 0 - 4095 corresponding to 0 - 100% 


6-38.6.4.1 Behavior 


Of instances 1, 2 and 3, only one is active at any given time. Which instance is active is 
determined by the value of the destination_used attribute of the Selection object instance. In 
typical operation, the destination_used attribute is mapped to, and hence modified by, the 
Regulation Select member of an Output Assembly Instance, which in turn, is referenced by the 
Consume Path of the first valid I/O connection established by the device. 
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6-38.6.4.2 Selection Object, Instance 1 
Table 6-38.14 Selection Object — Instance 1 Attribute Limitations 


Attribute Limitation (assigned values are shown in hex format) 


max_destination 03 


number_of_destinations | 03 

destination_list 06 / 20 / 33 / 24/01/30 / 06 — S-Single Stage Controller, Instance 1, Setpoint 
06 / 20 / 33 / 24/02 / 30/06 — S-Single Stage Controller, Instance 2, Setpoint 
06 / 20 / 33 / 24/03/30 / 06 — S-Single Stage Controller, Instance 3, Setpoint 
Access Rule = Get Only 


max_sources 00 
number_of_sources 00 
source_list Not Supported 
source_used 00 
algorithm_used 04 - Programmable Data Flow 
Access Rule = Get Only 
object_source_list 00 
Access Rule = Get Only 
destination_used Range = 0 -3 


6-38.6.5 Register Object 


6-38.6.5.1 Register Object, Instance 1 (Input) Operational Status 
Table 6-38.15 Data Attribute (8 Bits) 


Bit Description 
Power On Status (1=on / 0=off) 


Setpoint Status (1=at setpoint / 0=not) 


Temp Status (1=OK / 0=overtemp) 
Arc Detected (1=on / 0=off) 

Interlock Status Flag (1=OK / 0=open) 
Reserved for Future Use (0) 


Reserved for Future Use (0) 


NTO] UPR) Ww) Nyy rR|To 


Reserved for Future Use (0) 


— 6-225 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 6: Device Profiles, Part 4 


DC Power Generator Device, Type: 1Fyex 


6-38.6.5.2 Register Object, Instance 2 (Input) Interlock Status 
Table 6-38.16 Data Attribute (16 Bits) 


Bit Description 
0 Device Not Ready 
1 Communications Fault 
2 Device State Fault 
3 Device Not Configured 
4 External 
5 Head Cable 
6 Head Cover 
7 High-Voltage Cable 
8 Bias Supply 
9 DC Bus Voltage 
10 Fan Failure 
11 Magnet Temp 
12 Power Monitor 
13 Cover 
14 Reserved for Future Use (0) 
15 Reserved for Future Use (0) 


1 = Interlocked / 0 = Not Interlocked 


6-38.6.5.3 Behavior 


The transition of any interlock bit from 0 to 1 shall cause an internally generated Stop Service 
Request to the S-Device Supervisor object instance thereby causing a transition to the IDLE 
state and disabling the output power of the device. Also, if any interlock bit has a value of 1, 
the S-Device Supervisor object instance shall not transition to the EXECUTING State: (a) a 
Start Service Request shall return a Device_State_Conflict error, and (b) a Receipt of First 
Valid I/O Data event shall not cause a state transition. 


6-38.7. Defining Device Configuration 


Public access to the S-Device Supervisor and the application objects by the Message Router 
must be supported for configuration of this device type. 
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6-39 RF Power Generator Device 


Device Type: 20 hex 


An RF Power Generator is a device that converts AC utility power to regulated RF power. It 
uses sensors to monitor the output, and a controller, which closes the loop with a setpoint such 
that the output is controlled to the setpoint. The setpoint value can be a forward or delivered 
power level. The output frequency can be fixed, set with a user setpoint, or automatically 
tunable by a controller, which attempts to minimize reflected power. 


6-39.1 Object Model 
The Object Model in Figure 6-39.4 represents an RF Power Generator Device. The table below 
indicates: 


e the object classes present in this device 
e whether or not the class is required 
e the number of instances present in each class 


Table 6-39.1 Objects Present in a RF Power Generator Device 


Object Class Optional/Required # of Instances 

CIP Common Required Objects See Section 6-2.1 
Assembly Required at least 

4 Input and 

2 Output 
S-Device Supervisor Required 1 
S-Analog Sensor Required at least 3 

as many as 15 
S-Analog Actuator Required at least 2 

as many as 4 
S-Single Stage Controller Optional 1-3 
Selection Required 1 
Register Required 2 


6-39.2 Subclasses 


Some of the object classes used by this profile define class and/or instance level subclasses. 
Each subclass defines a unique meaning for an overlapping range of attribute IDs and/or 
service IDs. The range for subclass definitions begins at ID 96 and numbers downward for 
attributes, and ID 63h, and numbers downward for services. The subclass in use, for a given 
object class or instance, by the device is identified by the value of its Subclass attribute. The 
following tables specify the subclass ID and corresponding object class and/or instance ID for 
this profile. 


Table 6-39.2 S-Device Supervisor Object Subclass 


Object Subclass Name Subclass ID | Required Function Restrictions 
Instance (Attribute 
ID 99 Value) 
1 Power Generator 01 Required Device None 
Management 
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Table 6-39.3 S-Single Stage Controller Object Subclasses 


Object Subclass Name Subclass ID | Required Function Restrictions 
Instance (Attribute 

ID 99 Value) 

1 RF Generator 03 Optional Forward Data Units = Watts or 
Power milliWatts 
Regulation 

2 RF Generator 03 Optional Delivered Data Units = Watts 
Power 
Regulation 

3 Frequency Control 04 Optional Frequency Data Units = Hertz 
Regulation 
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Figure 6-39.4 Object Model for the RF Power Generator Device 
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How Objects Affect Behavior 


Table 6-39.5 Object Affect on Behavior 


Object 


Effect on behavior 


Identity 


Supports the Reset service. Upon receipt of a Reset Service 
Request of any Type, the Identity Object sends a Reset Service 
Request to the S-Device Supervisor. 


CIP Common Required | See Section 6-2.2 for details. 


Assembly 


Defines input/output and configuration data format 


S-Device Supervisor 


Supports the Stop, Start, Reset, Abort, Recover and 
Perform_Diagnostic services for ALL Application Objects in the 
device and consolidates the Exception Conditions and Application 
Objects’ Status. 


This object behaves differently from the Identity Object in that the 
S-Device Supervisor object provides a single point of access to the 
Application Objects only; it does not effect the DeviceNet specific 
objects (i.e., Identity, DeviceNet, Connection, etc.). 


S-Analog Sensor 


Provides sensed measurements and feeds process variables to the S- 
Single Stage Controllers 


S-Single Stage Controller 


The active instance feeds the control variable to the S-Analog 
Actuator thereby regulating the output as specified 


S-Analog Actuator 


Operates the Power Generator output drive circuitry 


Selection Activates an instance of the S-Single Stage Controller class and 
feeds it the Setpoint variable 
Register Instance 1 - No effect. 


Instance 2 - The transition of any interlock bit from 0 to 1 causes an 
internally generated Stop Service Request to the S-Device 
Supervisor object instance. 


Defining Object Interfaces 


Table 6-39.6 Object Interfaces 


Object 


Interface 


CIP Common Required See Section 6-2.3 for details. 


Assembly 


I/O Connection or Message Router 


S-Device Supervisor 


Assembly or Message Router 


S-Analog Sensor 
S-Analog Actuator 


Assembly or Message Router 


Assembly or Message Router 


S-Single Stage Controller 


Assembly or Message Router 


Selection 


Assembly or Message Router 


Register 


Assembly or Message Router 
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6-39.5 I/O Assembly Instances 


The following table identifies the I/O assembly instances. The manufacturer must specify 
which Assembly instances are supported by the device. 


Any element not supported must be set to zero (0). 


Table 6-39.7 I/O Assembly Instances 


Instance | Required | Type | Byte | Bit7 | Bit6 | BitS | Bit4 | Bit3 | Bit2 | Bit1 | Bito 


1 Y Output 
(Default) 


Forward Power Out 12 (low byte) 
0 Power Out 12 (high nibble) 
0 0 0 0 
0 0 0 0 
0 0 0 0 On 
Forward Power In 12 (low byte) 

0 0 0 0 Forward Power In 12 (high nibble) 
Reflected Power In 12 (low byte) 


0 0 0 0 Reflected Voltage In 12 (high 
nibble) 


0 


o;o!;}o;o 
oO;O;}o;}o 
o;o;}o;o 


2 Y Input 
(Default) 


o;o!;}o;o 
OoO;O!}o!;}o 
OoO;O}o!;}o 
o;o!}o;o 
oO;O!;}o;}o 


0 
0 
0 


0 0 0 0 0 0 0 On 


-3 Forward Power Limit 


Y Output 
4 N Output 


4-7 Delivered Power Limit 


8-11 Frequency Limit Low 


12-15 Frequency Limit High 


5 N Output |0-1 Regulation Select 
2-5 Setpoint 


-7 Power Ramp 
0 0 0 0 0 0 0 On 


Regulation Select 


1 
Oy] eR 


6 N Output 


Setpoint 
0 0 0 0 0 0 0 On 
Forward Power Out 
0 0 0 0 On 


Forward Power Out 


7 N Output 


1 
w 


8 N Output 


1 
uo} w 


Power Ramp 
0 0 0 0 0 0 0 On 
Delivered Power Out 
0 0 0 0 0 0 0 On 


9 N Output 


BLOOD! RI] OL RIL OIL ODINI|O]O];D 
1 
w 

Oo 

Oo 

Oo 
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Instance | Required | Type | Byte | Bit7 | Bit6 | BitS | Bit4 | Bit3 | Bit2 | Bit1 | Bito 


10 N Output 


-3 Delivered Power Out 
-5 


Power Ramp 


0 0 0 0 0 0 0 On 


11 N Input Ex Status 


-4 Forward Power In 
8 


Voltage In 


-12 Current In 


12 N Input Ex Status 


-4 Energy In 


13 N Input Ex Status 


PI}LOlLrRI]OLoOl]/ usr] olan] RIO 
1 


-4 Forward Power In 
5-8 Voltage In 
9-12 Current In 
13-16 Energy In 
14 N Input 0 Ex Status 
1-4 Forward Power In 
5-8 Reflected Power In 
9-12 Voltage In 
13-16 Current In 
15 N Input 0 Ex Status 


-4 Delivered Power In 


16 N Input Ex Status 
W Temp 


D Temp 


1 
RIM 


17 Y Input 
18 Y Input 


Ex Status 


Exception Detail Alarm 0 (size, common = 2) 


Exception Detail Alarm 1 (common 0) 


Exception Detail Alarm 2 (common 1) 


Exception Detail Alarm 3 (size, device = 2) 


Exception Detail Alarm 4 (device 0) 


Exception Detail Alarm 5 (device 1) 


Exception Detail Alarm 6 (size, manufacturer = 1) 


Exception Detail Alarm 7 (manufacturer 0) 


19 Y Input Exception Detail Warning 0 (size, common = 2) 


Exception Detail Warning 1 (common 0) 


Exception Detail Warning 2 (common 1) 


Exception Detail Warning 3 (size, device = 2) 


Exception Detail Warning 4 (device 0) 


Exception Detail Warning 5 (device 1) 


Exception Detail Warning 6 (size, manufacturer = 1) 


N] ODO]? O} Rl] WI NPR] ON] OD] OBR] WI NITR]|O]oO]wTr]o;yr 


Exception Detail Warning 7 (manufacturer 0) 
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Instance | Required | Type | Byte | Bit7 | Bit6 | BitS | Bit4 | Bit3 | Bit2 | Bit1 | Bito 


20 N Input Ex Status 


Exception Detail Alarm 0 (size, common = 2) 


Exception Detail Alarm 1 (common 0) 


Exception Detail Alarm 2 (common 1) 


0 

1 

2 

3 

4 Exception Detail Alarm 3 (size, device = 2) 
5 Exception Detail Alarm 4 (device 0) 
6 

7 

8 

9 


Exception Detail Alarm 5 (device 1) 


Exception Detail Alarm 6 (size, manufacturer = 1) 


Exception Detail Alarm 7 (manufacturer 0) 


Exception Detail Warning 0 (size, common = 2) 


10 Exception Detail Warning 1 (common 0) 


11 Exception Detail Warning 2 (common 1) 


12 Exception Detail Warning 3 (size, device = 2) 


13 Exception Detail Warning 4 (device 0) 


14 Exception Detail Warning 5 (device 1) 


15 Exception Detail Warning 6 (size, manufacturer = 1) 


16 Exception Detail Warning 7 (manufacturer 0) 


21 N Input 
22 N Input 


Op Status 


Interlock Status (low byte) 
0 0 Interlock Status (high 6 bits) 
Ex Status 


23 N Input 


Op Status 


Interlock Status (low byte) 


3 0 0 Interlock Status (high 6 bits) 


6-39.5.1 I/O Assembly Instance Component Formats 


All of the elemental components listed above follow standard CIP Data Encoding as specified 
in Appendix C. The encoding order for all data is Low Byte first. All members are LSB 
aligned and end on Byte boundaries. That is, upper bits are stuffed with 0 as needed to fill to 
the next byte. 


6-39.5.2 I/O Assembly Instance Component Mapping 


Each of the S-Analog Sensor, S-Analog Actuator and S-Single Stage Controller object 
definitions specifies a behavior that modifies the Data Type of certain attributes based upon the 
first valid I/O connection established to an Assembly Object instance. See these object 
definitions for more detail. 
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The following table indicates the I/O assembly Data attribute mapping for this device. 


Table 6-39.8 I/O Assembly Data Mapping 


Data Component Object Name See nee Attribute Name ai ciedseg Data Type 
ID ID ID 
Forward Power Out 12 | S-Single Stage 33hex 1 Setpoint 6 UINT 
Controller 
Forward Power In 12 _ | S-Analog Sensor 31hex 1 Value 6 UINT 
Reflected Power In 12 | S-Analog Sensor 31hex 2 Value 6 UINT 
Power Ramp S-Single Stage 33hex 1 Ramp Rate 96 UINT 
Controller Increment 
On S-Device Supervisor | 30pex 1 Output Power 96 BOOL 
Enable 
Op Status Register O7hex 1 Data 4 ARRAY of 
8 BITS 
Forward Power Limit | S-Single Stage 33hex 1 Output Limit 86 DINT 
Controller 
Delivered Power Limit | S-Single Stage 33hex 2 Output Limit 86 DINT 
Controller 
Frequency Limit Low | S-Single Stage 33hex 3 Frequency Limit |95 DINT 
Controller Low 
Frequency Limit High | S-Single Stage 33hex 3 Frequency Limit | 96 DINT 
Controller High 
Filament On/Off S-Device Supervisor | 30hex 1 Filament Power |95 BOOL 
Enable 
Regulation Select Selection 2Ehex 1 destination_used | 14 UINT 
Setpoint Selection 2Ehex 1 input_data_value |15 DINT 
Forward Power Out S-Single Stage 33hex 1 Setpoint 6 DINT 
Controller 
Forward Power In S-Analog Sensor 3lhex 1 Value 6 DINT 
Reflected Power In S-Analog Sensor 31hex 2 Value 6 DINT 
Voltage In S-Analog Sensor 31hex 4 Value 6 DINT 
Current In S-Analog Sensor 3lhex 5 Value 6 DINT 
Energy In S-Analog Sensor 3lhex 7 Value 6 DINT 
Delivered Power Out S-Single Stage 33hex 2 Setpoint 6 DINT 
Controller 
Delivered Power In S-Analog Sensor 31hex 3 Value 6 DINT 
W Temp S-Analog Sensor 31hex 8 Value 6 INT 
D Temp S-Analog Sensor 31hex 9 Value 6 INT 
Interlock Register O7hex 2 Data 4 ARRAY of 
16 BITS 
Ex Status S-Device Supervisor | 30pox 1 Exception Status | 12 BYTE 
Ex Alarm S-Device Supervisor | 30hex 1 Exception Detail | 13 STRUCT 
Alarm 
Ex Warn S-Device Supervisor | 30hex 1 Exception Detail | 14 STRUCT 
Warning 
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6-39.6 Object Limitations and Specific Definitions 


This section describes limitations and specific definitions applicable to the listed objects of this 
device profile when these objects are applied in this type of device. 


6-39.6.1 S-Device Supervisor 
The following attribute limitations apply: 


Table 6-39.9 Device Type Attribute Limitation 


Attribute Requirements 


Device Type Shall be set to "RFG" for RF Power Generator Device 


The following table specifies the data attribute bit mapping for the Device Exception Detail 
bytes for this device. For more descriptive information, see the definition of the S-Device 
Supervisor Object Class. 


Any Exception Bit not supported shall default to 0. Note that this profile allows for only one 
byte of manufacturer specific exception detail. 


Table 6-39.10 Data Attribute Bit Mapping 


Data Component Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
Device 0 0 0 0 0 1 0 0 
Exception Detail 
Size 
Device Magnetron | Power Contactor | Fan Cooling | Device Interlock | Control 
Exception Detail Assembly | Detector Closed Failure Failure Temp Open Circuit 
Byte 0 Fault Fault High Fault 
Byte 1 Input Input Output I | Output V | Output V | Reflecte | Output P | Regulation 
Power Power Low Low High dP High | High 
V Low V High * 
Byte 2 IGBT Xfmr I Magnet V | Bus V Bus V Bus DCI DC V 
Driver High High High Low Shorted | High Error 
Byte 3 Reserved Reserved End of Dew Non- Non- AnodeI | Anode V 
0 0 Target Conden- | Zero Idle | Zero Idle | High High 
Life * sation Output I | Output V 
Manufacturer | 0 0 0 0 0 0 0 1 
Exception Detail 
Size 
Manufacturer | 8 Bits defined by Manufacturer 
Exception Detail 
Byte 0 


* Only used in the Warning Exception Detail, this bit is always = 0 in the Alarm Exception Detail. 


— 6-235 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 6: Device Profiles, Part 4 


RF Power Generator Device, Type: 20nex 


6-39.6.2. S-Analog Sensor Object Instances 


Table 6-39.11 Object Instances 


Object 
Instance Function Required Limitations and Specific Definitions 
ID 
1 Forward Power Required Supported Data Type and Data Units pairs: 
DINT / Watts; 
DINT / milliWatts 
UINT / % * 


2 Reflected Power Required Supported Data Type and Data Units pairs: 
DINT / Watts (rms); 

DINT / milliWatts (rms) 

UINT / % * 


3 Delivered Power Optional Supported Data Type and Data Units pairs: 
DINT / Watts (rms); 

DINT / milliWatts (rms) 

UINT / % * 


4 Output Voltage Optional Supported Data Type and Data Units pairs: 
DINT / Volts (rms); 
UINT / % * 


5 Output Current Optional Supported Data Type and Data Units pairs: 
DINT / milliAmps (rms); 
UINT / % * 


6 Output Frequency Required DINT / Hertz 


Delivered Energy Optional DINT / Joule 
since Output Power 
was last turned On 


8 Cooling Water Optional INT /°C 

Temp Resolution = 1 Degree 
9 Device Temp Optional INT /°C 

Resolution = 1 Degree 

10 Plate Voltage Optional UINT / Volts 
11 Plate Current Optional UINT / milliAmps 
12 Grid Voltage Optional UINT / Volts 
13 Grid Current Optional UINT / milliAmps 
14 Driver Forward Optional UINT / Watts 

Power 
15 Driver Reflected Optional UINT / Watts 

Power 


* Range = 0 - 4095 corresponding to 0 - 100% 
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6-39.6.3. S-Analog Actuator Object Instances 


Table 6-39.12 Object Instances 


Object 
Instance Function Required Limitations and Specific Definitions 
ID 
1 Output Power Required | Supported Data Type and Data Units pairs: 
DINT / Watts; 
DINT / milliWatts 
UINT / % * 
2 Output Frequency Required | Supported Data Type and Data Units pairs: 
DINT / Hertz; 
UINT / % * 
3 Variable Tuning Optional | USINT / % of Max 
Element 1 
4 Variable Tuning Optional | USINT / % of Max 
Element 2 


* Range = 0 - 4095 corresponding to 0 - 100% 


6-39.6.3.1 S-Single Stage Controller Object Instances 
Table 6-39.13 Object Instances 


pies: Function Required Limitations and Specific Definitions 
Instance ID 
1 Output Forward Optional Supported Data Type and Data Units pairs: 
Power Regulation DINT / Watts; 
DINT / milliWatts 
UINT / % * 
2 Output Delivered | Optional Supported Data Type and Data Units pairs: 
Power Regulation DINT / Watts; 
DINT / milliWatts 
UINT / % * 
3 Output Frequency | Optional Supported Data Type and Data Units pairs: 
Regulation DINT / Hertz; 
UINT / % * 


* Range = 0 - 4095 corresponding to 0 - 100% 


6-39.6.3.2 Behavior 


Of instances 1 and 2, only one is active at any given time. Which instance is active is 
determined by the value of the destination_used attribute of the Selection object instance. In 
typical operation, the destination_used attribute is mapped to, and hence modified by, the 
Regulation Select member of an Output Assembly Instance, which in turn, is referenced by the 
Consume Path of the first valid I/O connection established by the device. 
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6-39.6.4 Selection Object, Instance 1 


Table 6-39.14 Object Instances 


Attribute Limitation (assigned values are shown in hex format) 


Max_destination 02 


Number_of_destinations | 02 
Destination_list 06 / 20 / 33 / 24/01/30 / 06 —S-Single Stage Controller, Instance 1, Setpoint 


06 / 20 / 33 / 24/02/30 / 06 — S-Single Stage Controller, Instance 2, Setpoint 
Access Rule = Get Only 


Max_sources 00 

Number_of_sources 00 

Source_list Not Supported 

Source_used 00 

Algorithm_used 04 - Programmable Data Flow. Access Rule = Get Only 
Object_source_list 00 Access Rule = Get Only 

Destination_used Range = 0-2 


6-39.6.5 Register Object 
6-39.6.5.1 Register Object, Instance 1 Operational Status 
Table 6-39.15 Object Instances 


Bit Description 
Power On Status (1=on / 0=off) 


Setpoint Status (1=at setpoint / 0=not) 
Temp Status (1=OK / 0=overtemp) 
Reserved (0) 

Interlock Status (1=OK / 0=open) 


Reserved for Future Use (0) 


Reserved for Future Use (0) 


NYP ODO) oO} BR] WI] NR} oO 


Reserved for Future Use (0) 
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6-39.6.5.2 Register Object, Instance 2 Interlock Status 
Table 6-39.16 Object Instances 


Bit Description 
0 Device Not Ready 
1 Communications Fault 
2 Device State Fault 
3 Device Not Configured 
4 External 
5 Head Cable 
6 Head Cover 
7 High-Voltage Cable 
8 Bias Supply 
9 DC Bus Voltage 
10 Fan Failure 
11 Magnet Temp 
12 Power Monitor 
13 Cover 
14 Reserved for Future Use (0) 
15 Reserved for Future Use (0) 


1 = Interlocked / 0 = Not Interlocked 


6-39.6.5.3 Behavior 


The transition of any interlock bit from 0 to 1 shall cause an internally generated Stop Service 
Request to the S-Device Supervisor object instance thereby causing a transition to the IDLE 
state and disabling the output power of the device. Also, if any interlock bit has a value of 1, 
the S-Device Supervisor object instance shall not transition to the EXECUTING State: (a) a 
Start Service Request shall return a Device_State_Conflict error, and (b) a Receipt of First 
Valid I/O Data event shall not cause a state transition. 


6-39.7. Defining Device Configuration 


Public access to the S-Device Supervisor and the application objects by the Message Router 
must be supported for configuration of this device type. 
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6-40 Fluid Flow Controller Device 
Device Type: 24 hex 


A Fluid Flow Controller (FFC) is a device that measures and controls the flow rate of a fluid 
(liquid or gas). It contains three principle components: a flow rate sensor which can be a 
virtual sensor based on other sensors, for example pressure; a fluid flow metering valve which 
can be actuated by one of a variety of actuator types, including, for example, solenoid or a 
stepper motor; and, a controller which closes the loop by receiving a setpoint and driving the 
actuator such that the fluid flow rate is controlled to the setpoint. 


6-40.1 Object Model 


The Object Model in Figure 6-40.2 represents a Fluid Flow Controller Device. The table below 
indicates: 


e the object classes present in this device 
e whether or not the class is required 
e the number of instances present in each class 


Table 6-40.1 Objects Present in a Fluid Flow Controller Device 


Object Class Optional/Required # of Instances 
Identity Required 1 
Message Router Required 1 
DeviceNet Required 1 
Connection Required at least 
1 1/O and 
1 Explicit 
Assembly Required at least 
1 Input and 
1 Output 
S-Device Supervisor Required 1 
S-Sensor Calibration * Optional 0 or More 
or 
S-Gas Calibration * 
S-Analog Sensor Required 1 or More 
S-Analog Actuator Conditional ** 1 
S-Single Stage Controller Conditional ** 1 


* For FFC devices that flow Liquid, the S-Sensor Calibration object is used. 
For FFC devices that flow Gas, the S-Gas Calibration object is used. 


** Required for a Fluid Flow Controller, a device that contains a Valve and a Controller. Not 
supported in a Fluid Flow Meter Device. 
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6-40.2 Class Subclasses 


Each class level subclass defines a unique meaning for an overlapping range of class attribute 
IDs and/or class service IDs. The range for subclass definitions begins at ID 96 and numbers 
downward for attributes, and ID 63),., and numbers downward for services. The subclass for a 
given class is identified by the value of its Subclass class attribute. There are no class level 
subclasses specified for this device. 


6-40.3. Instance Subclasses 


Each instance level subclass defines a unique meaning for an overlapping range of instance 
attribute IDs and/or instance service IDs. The range for subclass definitions begins at ID 96 
and numbers downward for attributes, and ID 63),., and numbers downward for services. The 
subclass for a given instance is identified by the value of its Subclass instance attribute. 


The only instance level subclass specified for this device is: 


e S-Analog Sensor Object, Instance Identifier 01 -- Subclass 01, Flow Diagnostics 


6-40.4 Instance Identifiers 


Additional objects are restricted for the purposes of reserving instance number ranges for future 
revisions of this device profile. As permitted by CIP, vendor-specific objects (object classes in 
the range 100-199 or 768-1279) may be added without instance number restrictions. However, 
open objects (i.e., all objects defined by the CIP Common Specification, but not included in 
"CIP Common Specification, Table 6-2.2, Minimum Objects Required for All Devices") may 
only be added (as vendor-specific additions) using instance numbers in the range 100-199 or 
768-1279, the vendor-specific open object instance number range for this device type. This 
allows object extensions to this device profile specification in future revisions (i.e., added open 
objects defined with instance identifiers < 100). 
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Figure 6-40.2 Object Model for the FFC Device 
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Table 6-40.3 S-Analog Sensor Instances 
S-Analog Sensor Description 
Instance 1 * Flow Virtual sensor that calculates the fluid flow rate based on 
various sensed parameters, for example differential pressure 

Instance 2 (optional) The measured fluid pressure 

Instance 3 (optional) The measured fluid temperature 
Instance 4 (optional) 


The measured fluid density 
* Subclass 01, Flow Diagnostics 
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6-40.5 


6-40.6 


6-40.7 


Fluid Flow Controller Device, Type: 24 Hex 
How Objects Affect Behavior 


Table 6-40.4 Object Affect on Behavior 


Object 
Identity 


Message Router 
DeviceNet 
Connection Class 
Assembly 


S-Device Supervisor 


S-Sensor Calibration 


S-Analog Sensor 


S-Single Stage Controller 


S-Analog Actuator 


Effect on behavior 


Supports the Reset service. Upon receipt of a Reset Service Request of any 
Type, the Identity Object sends a Reset Service Request to the S-Device 
Supervisor. 


No effect 

Configures port attributes (node address, data rate, and BOT) 
Contains the number of logical ports into or out of the device 
Defines input/output and configuration data format 


Supports the Stop, Start, Reset, Abort, Recover and Perform_Diagnostic 
services for ALL Application Objects in the device and consolidates the 
Exception Conditions and Application Objects’ Status. 


This object behaves differently from the Identity Object in that the S-Device 
Supervisor object provides a single point of access to the Application Objects 
only; it does not effect the DeviceNet specific objects (i.e., Identity, DeviceNet, 
Connection, etc.). 


Modifies the correction algorithm of the related S-Analog Sensor object which 
includes the selection mechanism to enable an S-Sensor Calibration object 
instance. 


A virtual sensor determines the measured fluid flow rate or other parameter. 
The flow sensor feeds the process variable to the S-Single Stage Controller 
object 


Feeds the control variable to the S-Analog Actuator object 


Operates the Flow Control Valve of the device 


Defining Object Interfaces 


Table 6-40.5 Object Interfaces 


Object 
Identity 
Message Router 
DeviceNet 
Connection Class 
Assembly 
S-Device Supervisor 
S-Sensor Calibration 


S-Analog Sensor 


S-Single Stage Controller 


S-Analog Actuator 


Interface 
Message Router 
Explicit Messaging Connection Instance 
Message Router 
Message Router 
I/O Connection or Message Router 
Assembly or Message Router 
Message Router 
Assembly or Message Router 
Assembly or Message Router 


Assembly or Message Router 


I/O Assembly Instances 


The following table identifies the I/O assembly instances supported by the FFC. As specified 


by the Assembly Object definition, the range of instances up to 99 are reserved for future 
specification revision to this profile. 


— 6-243 — 
Edition 3.3 


ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 6: Device Profiles, Part 4 


Fluid Flow Controller Device, Type: 24 Hex 
Table 6-40.6 FFC I/O Assembly Instances 


Number Type Name 

Status and Flow 

Status, Flow and Pressure 

Status, Flow and Temperature 

Status, Flow, Pressure and Temperature 
Status, Flow, Pressure and Valve 

Status, Flow, Pressure, Temperature and Valve 
Status, Flow, Setpoint and Valve 

Status, Flow, Setpoint, Override and Valve 
10 C* (default) Setpoint 

Override and Setpoint 

FP-Flow 

Status and FP-Flow 

Status, FP-Flow and FP-Pressure 

Status, FP-Flow and FP-Temperature 


Status, FP-Flow, FP-Pressure and FP-Temperature 


Status, FP-Flow, FP-Pressure and FP-Valve 


Status, FP-Flow, FP-Pressure, FP-Temperature and FP-Valve 


Status, FP-Flow, FP-Setpoint and FP-Valve 

Status, FP-Flow, FP-Setpoint, FP-Override and FP-Valve 
FP-Setpoint 

Override and FP-Setpoint 

Status, Flow, Density 

Status, Flow, Density, Temperature 


Status, Flow, Pressure, Temperature and Density 
Status, Flow, Pressure, Temperature, Density and Valve 


Status, FP-Flow, FP-Density 


Status, FP-Flow, FP-Density, FP-Temperature 


Input Status, FP-Flow, FP-Pressure, FP-Temperature and FP- 
Density 

Input Status, FP-Flow, FP-Pressure, FP-Temperature, FP-Density 
and FP-Valve 


* Required for a Fluid Flow Controller, a device that contains a Valve and a Controller. Not 
supported in a Fluid Flow Meter Device. 
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6-40.8 I/O Assembly Object Instance Data Attribute Encoding 


The manufacturer of a Fluid Flow Controller Device must specify which Assembly instances 
are supported by the device. 


The I/O Assembly DATA attribute is formatted as a structure of data elements with the first 
element ordered first. All data components are encoded with the Low-ordered Byte first; that 
is, the Least Significant Byte is in the Low-ordered Index (Address) i.e., Little Endian. 
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6-40.9 Mapping I/O Assembly Data Attribute Components 


Each of the S-Analog Sensor, S-Analog Actuator and S-Single Stage Controller object 
definitions specifies a behavior that modifies the Data Type of certain attributes based upon the 
first valid I/O connection established to an Assembly Object instance. In order to maintain 
consistency, this device type is limited to only allow connections to either INT or REAL based 
Assembly instances. Once a valid connection is established, attempts to configure connections 
to a different type of Assembly instance will return an error. 


The following table indicates the I/O assembly Data attribute mapping for this FFC device. 


Table 6-40.7 I/O Assembly Data Mapping 


Data Component Class Instance Attribute 


Setpoint S-Single Stage 33hex 1 Setpoint INT 
Controller 


Status 


FP-Setpoint S-Single Stage 33hex 1 Setpoint 6 REAL 
Controller 


4/4] 4] 4 


6-40.10 Object Limitations and Specific Definitions 


This section describes limitations and specific definitions applicable to the listed objects of this 
device profile when these objects are applied in this type of device. 


— 6-245 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 6: Device Profiles, Part 4 
Fluid Flow Controller Device, Type: 24 Hex 


6-40.10.1 S-Device Supervisor Object Instance 

Table 6-40.8 Limitations 
Attribute Limitation 

Device Type Supported Values: 

“FFC” = Fluid Flow Controller device (Liquid Type) 

“FFM” = Fluid Flow Meter device (Liquid Type) 

"FCG" = Fluid Flow Controller device (Gas Type) 

"FMG" = Fluid Flow Meter device (Gas Type) 


6-40.10.2 Specific Definition 


The following table specifies the data attribute bit mapping for the Device Exception Detail 
bytes for this FFC device. For more descriptive information, see the definition of the S-Device 
Supervisor Object Class. Noted, for each entry, is the Object from which the Status byte/bit is 
mapped. See the object specification for the detailed bit mapping. 


Any Exception Bit not supported must default to 0. Note that this profile allows for only one 
byte of manufacturer specific exception detail. 


Table 6-40.9 Bit Mapping for Device Exception Detail 


FFC Device 1 1 

Exception Detail 

Size 

FFC Device Pressure | Pressure | Valve Valve Flow Flow Flow Reading 

Exception Detail | High Low High Low Control High Low Valid 

[0] S-Analog | S-Analog | S-Analog | S-Analog |S-Single | S-Analog | S-Analog * 

Sensor 2 |Sensor2 | Actuator | Actuator | Stage Sensor 1 |Sensor1 | S-Analog 

Controller Sensor 1 

FFC Device Density Density |Temp Temp 

Exception Detail High Low High Low 

(1] S-Analog |S-Analog |S-Analog | S-Analog 
Sensor4 |Sensor4 |Sensor3 | Sensor 3 

FFC Device 0 

Exception Detail 

[2] 

Manufacturer 1 

Exception Detail 

Size 


Manufacturer 8 Bits defined by Manufacturer 
Exception Detail 


* Only used in the Warning Exception Detail, this bit is always = 0 in the Alarm Exception 
Detail 
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6-40.10.3 S-Analog Sensor Object 


Table 6-40.10 Limitations Instance 1 


Attribute Limitation Requirement Default 
Data Type Supported Values = {INT; REAL} Supported Values = {INT} INT 


Data Units Supported Values = {Counts, % & Supported Values = Counts * 
Units of the Flow Group} (see {counts} 
Appendix K) 


Subclass 01 = Flow Diagnostics 


Table 6-40.11 Limitations Instances 2 


Attribute Limitation Requirement Default 
Data Type Supported Values = {INT; REAL} Supported Values = {INT} INT 
Data Units Supported Values = {Counts, % & Supported Values = Counts * 
Units of the Pressure Group} (see {counts} 
Appendix K) 


Table 6-40.12 Limitations Instance 3 


Attribute Limitation Requirement Default 
Data Type Supported Values = {INT; REAL} Supported Values = {INT} INT 
Data Units Supported Values = {Counts, % & Supported Values = Counts * 
Units of the Temperature Group} (see {counts} 
Appendix K) 


Table 6-40.13 Limitations Instance 4 


Attribute Limitation Requirement Default 
Data Type Supported Values = {INT; REAL} Supported Values = {INT} INT 
Data Units Supported Values = {Counts, % & Supported Values = Counts * 
Units of the Density Group} (see {counts} 
Appendix K) 


* Counts are interpreted as a "Percent of Full Scale" where a Count Value of 24576 (6000 
hexadecimal) corresponds to 100%. This allows a maximum reading of 133.33%. 


6-40.10.4 S-Analog Actuator Object 


Table 6-40.14 Limitations 


Attribute Limitation Requirement Default 
Data Type Supported Values = {INT; REAL} Supported Values = {INT} INT 


Data Units Supported Values = {Counts, %, Supported Values = {counts} Counts * 
Voltage, Current & Units of the 
Flow Group} (see Appendix K) 


* Counts are interpreted as a "Percent of Full Scale" where a Count Value of 24576 (6000 
hexadecimal) corresponds to 100%. This allows a maximum reading of 133.33%. 
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6-40.10.5 S-Single Stage Controller Object 


Table 6-40.15 Limitations 


Attribute Limitation Requirement Default 
Data Type Supported Values = {INT; REAL} Supported Values = {INT} INT 
Data Units Supported Values = {Counts, %, & Supported Values = {counts} Counts * 


Units of the Flow Group} (see 
Appendix K) 


Process Not accessible over the network. The A. N.A. 
Variable Process Variable input to this object 

instance is the value of the S-Analog 

Sensor object instance Value 


attribute. 
CV Data Not supported N.A. N.A. 
Type 
Control Not accessible over the network, The A. N.A. 
Variable Control Variable output from this 


object is the value of the S-Analog 
Actuator object instance Value 
attribute. 


* Counts are interpreted as a "Percent of Full Scale" where a Count Value of 24576 (6000 
hexadecimal) corresponds to 100%. This allows a maximum reading of 133.33%. 


The Data Type and Data Units of the S-Single Stage Controller object shall remain consistent 
with those of the S-Analog Sensor object Instance 1 (Flow). Any change to the value of the 
Data Type or Data Units attribute of either of these two object instances will cause the device 
to self-modify the value of the corresponding attribute of the other object. 


6-40.11 Defining Device Configuration 


Public access to the S-Device Supervisor, S-Analog Sensor, S-Analog Actuator, S-Single Stage 
Controller, and S-Sensor Calibration Objects by the Message Router must be supported for 
configuration of this device type. 
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6-41.1 


6-41.2 


6-41.2.1 


CIP Motion Drive, Type: 25hex 


CIP Motion Drive 
Device Type: 25hex 
Introduction 


A CIP Motion™ Drive device controls the motion of one or more motion axes, typically 
consisting of a rotary or linear motor actuator and one or more optional feedback devices. Each 
associated motor is driven by an associated drive power structure that is also part of the device. 
Motor control functionality supported by this profile can be applied to “open loop” Variable 
Frequency Drives or “closed loop” Vector Controlled Servo Drives. In either case, axis motion 
is controlled via a command reference that can be configured for position control, velocity 
control, acceleration control, or current/torque control. This profile also supports the use of 
additional motion axis feedback channels as master feedback sources. 


Object Model 
The object model in Figure 6-41.1 represents a CIP Motion Drive device. The table below 
indicates: 


e the object classes present in this device 
e whether or not the class is required 
e the number of instances present in each class 


Chapter 5, Object Library, provides more details about these objects. 


Table 6-41.1 Object Present in a CIP Motion Drive Device 


Object Class # of Instances 
CIP Required Objects See Chapter 6-2.1 
Time Sync Object 1 
Motion Axis Object 1 per Axis 


Object Description 


The object model shown below describes the main functional components of the CIP Motion 
Drive device profile defined as part of the motion control extensions to CIP. This profile is 
required to support motion control when connected to a motion controller that supports these 
motion control extensions to CIP, through a CIP network. Applicable CIP Networks would be 
DeviceNet, ControlNet, and EtherNet/IP. EtherNet/IP is the network of choice for high 
performance, synchronized multi-axis control. ControlNet and DeviceNet is only be targeted 
for lower performance non-synchronized drive applications such as simple variable frequency 
drives, velocity loop drives, and indexing drives. 


The object model below also illustrates the use of multiple instances of a Motion Axis Object 
in multi-axis motion implementations.. Each Motion Axis Object instance governs the behavior 
of the associated motion axis. 


A single bi-directional I/O connection to the Motion Axis Object instance provides a cyclic 
data path between the controller and each individual Motion Axis Object instance. This 
connection passes on a special data structure whose self-defining format can be used to transfer 
cyclic, event, and service related data. 
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An optional Time Sync Object is included in the object model to facilitate accurate time 
synchronization between motion controllers and motion axes for high performance motion 
control. For lower performance motion control such as V/Hz or VFD drives, the Time Sync 
Object is not necessary for motion axis operation. 


Figure 6-41.1 Object Model For a CIP Motion Drive 
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6-41.3 How Objects Affect Behavior 


The objects for this device affect the device’s behavior as shown in the table below. 


e The object classes present in this device 
e Whether or not the class is required 
e The number of instances present in each class 


Table 6-41.2 Object Effect on Behavior 


Object Class Effect on Behavior 
CIP Required Objects See Section 6.2.2 for details. 
Motion Axis object Provides dynamic control interface to drive, motor, and feedback 


components that comprise an axis. 


Time Sync Object Provide absolute time synchronization services between the motion 
controller device and the motion axis devices on the control network. 
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6-41.5 


6-41.5.1 


CIP Motion Drive, Type: 25hex 


Defining Object Interfaces 
Objects supported for the motion axis device have the interfaces listed in the table below. 
Table 6-41.3 Object Interfaces 


Object 
CIP Required Objects 


Motion Axis object 


Interface 


See Chapter 6-2.3 
Message Router or Motion Axis object Class 


Time Sync Object Message Router or Motion Axis object Class 


I/O Connection Messages 


This profile supports a point-to-point bi-directional I/O connection between the controller and 
the Motion Axis Object class. (This I/O connection is specifically referred to as the Motion I/O 
Connection.) The Motion Axis Object distributes the data in this connection to each 
instantiated Motion Axis Object instance. Therefore, the produced and consumed connection 
paths explicitly target Motion Axis Object class attributes (i.e. instance 0). The Consumed 
Connection path corresponds to the Controller-to-Device Connection while the Produced 
Connection path corresponds to the Device-to-Controller Connection as defined in detail the 
following section. The I/O Connection paths for this device are as follows: 


Consumed Connection Path = Motion Axis Object class / Instance 0 / (Controller Consumed 
Connection Data attribute) 


Produced Connection Path = Motion Axis Object class / Instance 0 / (Controller Produced 
Connection Data attribute) 


Motion Drive Connection 


The following section is a description of the Motion Drive Connection format that includes the 
Controller-to-Device Connection and the Device-to-Controller Connection for bi-directional 
data transfer between a motion controller and a motion axis. 


Table 6-41.4 Controller-to-Device Connection Format 


€ 32-bit Word > 


Controller-to-Device Connection Format 


Connection Header 


Instance Data Blocks 


Connection Header 


Connection Format Format Revision Update ID Node Control 


Instance Count - - Time Data Set 


Controller Update Period 


Controller Time Offset 


Controller Time Stamp 
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Instance Data Block 


Instance Data Header 
Cyclic Data Block 
Cyclic Write Data Block 
Event Data Block 


Service Data Block 


Instance Data Header 


Instance Number - Instance Block Size Cyclic Block Size 
Cyclic Command Cyclic Write Block Event Block Size Service Block Size 
Block Size Size 
Cyclic Data Block 
Control Mode Feedback Axis Control - 
Configuration 
Command Data Set Actual Data Set Status Data Set Interpolation Control 
Cyclic Data 
Cyclic Write Data Block 
Cyclic Write Block ID Cyclic Read Block ID 
Cyclic Write Data 
Event Data Block 
Event Checking Control 
Event Ack. ID 1 Event Ack. Status 1 Event Ack. ID 2 Event Ack. Status 2 


Service Data Block 


Transaction ID Service Code - - 


Service Specific Request Data 


Table 6-41.5 Device-to-Controller Connection Format 


€ 32-bit Word > 
Device-to-Controller Connection Format 
Connection Header 


Instance Data Blocks 


Connection Header 


Connection Format Format Revision Update ID Node Status 
Instance Count Node Alarms Node Faults Time Data Set 
Device Update Period 


Device Time Offset 


Device Time Stamp 


Timing Diagnostic Data 
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Instance Data Block 


Instance Data Header 
Cyclic Data Block 
Cyclic Read Data Block 
Event Data Block 


Service Data Block 


Instance Data Header 
Instance Num - Instance Block Size Cyclic Block Size 


Cyclic Actual Block Cyclic Read Block Event Block Size Service Block Size 
Size Size 


Cyclic Data Block 


Control Mode Feedback Axis Response Response Status 
Configuration 


- Actual Data Set Status Data Set Axis State 


Cyclic Data 


Cyclic Read Data Block 
Cyclic Read Block ID - 
Cyclic Read Data 


Event Data Block 
Event Checking Status 


Event ID Event Status Event Type - 


Event Position 


Event Time Stamp 


Service Data Block 


Transaction ID Service Code General Status Extended Status 


Service Specific Response Data 


6-41.5.1.1 Motion I/O Connection Overview 
The Motion I/O Connection actually consists of two unidirectional unicast connections; one 
passing data from the motion controller to the motion axis and the other passing data from the 
motion axis to the motion controller. 


6-41.5.1.2 Motion Connection Structure 


Both the Motion I/O Connection data structures (controller-to-device and device-to-controller) 
begin with a Connection Header that includes a 32-bit time stamp, followed by a series of data 
blocks for each axis instance supported by the device. 
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Each instance data block within the Motion I/O Connection packet consists of three sets of data 
blocks associated with the cyclic, event, and service data channels. The size of these data 
blocks for a given update is variable and determined by the connection and instance data block 
headers. From the motion axis device’s perspective, these three distinct data channels have 
different data processing priorities as illustrated in the diagram below. 


Figure 6-41.2 Motion I/O Connection Channels 
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The specific functionality of these three data channels is as follows: 


e Cyclic Data Channel — carries cyclic data blocks that are sampled or calculated every 
Controller Update Period and synchronized with other nodes in the motion control system 
through use of distributed System Time. Cyclic data is high priority data that must be 
immediately processed and applied to the motion axis within one DeviceUpdate Period. 

e Event Data Channel - carries event data associated with motion axis event(s) (e.g. 
registration, homing, etc.) that have occurred within the last Controller Update Period. 
Event data is medium priority and must be processed and applied within one Controller 
Update Period. 

e Service Data Channel — carries data associated with service requests to read or write 
attribute values of the Motion Axis Object as part of on-line configuration and diagnostic 
functionality, as well as service requests to affect Motion Axis Object behavior as part of 
controller instruction execution. Service data has lowest priority and is typically buffered 
and processed as a background task. There is no guarantee that a service request will be 
processed within Controller Update Period. 


Taken together, these three data channels provide a comprehensive motion controller to motion 
axis device data connection solution for industrial motion control. 


6-41.5.2 Controller-to-Device Connection 


To facilitate a detailed description of each of its constituent data elements, the Controller-to- 
Device Connection is organized as follows: 


Table 6-41.6 Controller-to-Device Connection Format 


Controller-to-Device Connection Format 


Connection Header 


Instance Data Blocks 
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Controller-to-Device Connection Header 


The Controller-to-Device Connection Header contains critical axis configuration information 
needed to parse the Instance Data Blocks. The fixed portion of the connection header is defined 
as follows. 


Table 6-41.7 Connection Header 


Connection Header 


Connection Format Format Revision Update ID Node Control 


e Connection Format: This enumerated byte determines the format of the connection 
according to the following definition: 


Table 6-41.8 Connection Format 


Connection Format 
Bit 7 Bit 0 


(Reserved) Connection Type 


e Connection Type: This 4-bit enumeration defines the connection type as shown below. 
Valid values for a Controller-to-Device Connection are 2 and 6. Fixed connections have a 
fixed connection size during operation to support other CIP networks like ControlNet and 
DeviceNet, and typically associated with a simple single axis device that does not support 
time synchronization services. Variable connections allow the connection data structure to 
vary in size during operation and is targeted for high-performance motion and CIP 
networks like EtherNet/IP. 


O = Reserved 

1 = Reserved 

2 = Fixed Controller-to-Device Connection 

3 = Fixed Device-to-Controller Connection 

4 = Reserved 

5 = Reserved 

6 = Variable Controller-to-Device Connection 
7 = Variable Device-to-Controller Connection 
8-15 = Reserved 


e Format Revision: This release of the specification defines Format Revision 1. Devices 


utilizing this version of the specification will only recognize Format Revision 1. This value 
is incremented by 1 for every revision of the Controller-to-Device Connection format that 
impacts the interface. The Format Revision allows newer motion axis devices to support 
the connection formats generated by an older controller. It also allows older motion axis 
devices to recognize a newer connection format from a controller that it cannot support and 
generate an appropriate error. 
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e Update ID: This cyclic transaction number is incremented every update period. The 
Update ID is like the CIP sequence count and is used by the motion axis device to 
determine whether the connection buffer contains fresh data. If the Update ID has not 
changed, the motion axis device attempts to ride through the missed update by 
extrapolation based on previous trajectory until fresh data arrives. In the case where the 
motion axis is not synchronized, or does not support time synchronization services, the 
time stamp data is either not included or invalid, so the Update ID is the only way for the 
motion axis device to detect new connection data. In this case, the Controller-to-Device 
connection Update ID is applied to the next Device-to-Controller connection Update ID. 

e Node Control: This element is applied to the Motion Axis Object class attribute, Node 
Control, which is used to control the state of the associated drive communications node. 
See Motion Axis Object for detail. 


6-41.5.2.1.1 Fixed Connection Header 
If the Connection Format is a Fixed Controller-to-Device Connection the above header is 
immediately followed by the instance data block. 

6-41.5.2.1.2 Variable Connection Header 


If the Connection Format is a Variable Controller-to-Device Connection then the connection 
header contains additional fields related to multi-axis motion device addressing and time 
stamping. 


Table 6-41.9 Connection Header 


Connection Header 


Connection Format Format Revision Update ID Node Control 


Instance Count - - Time Data Set 


Controller Update Period 


Controller Time Offset 


Controller Time Stamp 


e Instance Count: This value reflects the number of instance data blocks present in the 
Controller-to-Device Connection data structure. 

e Time Data Set: This bit-mapped byte contains flags that determine the usage and format of 
the controller and motion axis device timing information. The Time Data Set value sent by 
the controller in the Controller-to-Device connection becomes the Time Data Set value sent 
by the motion axis device in the Device-to-Controller connection. The value of this element 
is transferred to the Motion Axis Object attribute, Command Data Set. 


Table 6-41.10 Time Data Set 


Bit Definition Syntax 


0 Update Period 0 = no update period 
1 = update period included 


1 Time Stamp 0 = no time stamp & offset 
1 = time stamp & offset included 


2 Time Diagnostic Data 0 = no diagnostic data 
1 = diagnostic data included 


3-7 Reserved 
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Controller Update Period: This 32-bit element specifies the update period of the 
Controller-to-Device connection in nanoseconds. The value of this element is transferred to 
the Motion Axis Object class attribute of the same name. When the connection is 
synchronized, the Controller Update Period can be used by the motion axis device along 
with the Controller Time Stamp to check for missed or late updates. If the difference 
between the last Controller Time Stamp and the current local motion axis device time 
stamp exceeds the maximum value given by, 


Max Delay = Controller Update Delay High Limit * Controller Update Period, 


the Controller Update Fault bit is set in the Node Faults class attribute of the Motion Axis 
Object. An optional Controller Update Delay Low Limit attribute is also available. If the 
difference between the last Controller Time Stamp and the current local motion axis device 
time stamp exceeds the maximum value given by, 


Max Delay = Controller Update Delay Low Limit * Controller Update Period, 


the Controller Update Alarm bit is set in the Node Alarm class attribute of the Motion Axis 
Object. 


When the connection is synchronized and fine interpolation is enabled, the Controller 
Update Period is also used by the drive along with the Controller Time Stamp value to 
compute new coefficients to the interpolation/extrapolation polynomial. 


In the case where the connection is not synchronized, no late update checks are performed 
by the motion axis device. In this case the command data should be applied immediately, 
which means applying the data immediately as a command reference. 


Controller Time Offset: This element represents the 64-bit System Time Offset value 
associated with the Controller Time Stamp that follows. The value of this element is 
transferred to the Motion Axis Object class attribute of the same name. The Controller 
Time Offset value is used by the motion axis device to determine if System Time as 
defined in the motion controller is skewed relative to System Time in the motion axis 
device. Normally, System Time between the motion axis device and the motion controller 
are closely matched at any given time. But every few seconds, according to the IEEE-1588 
protocol, the time master of the system can correct the System Time reference by a 
significant amount of time, perhaps an hour. Indeed, even the master itself can change as a 
higher quality time master is discovered by the system. These step changes to the System 
Time reference propagate through to the various devices on the network in such a way that 
the controller and the motion axis device are running with skewed System Time values. 
The Controller Time Offset value can be used together with the System Time Offset for the 
motion axis device to both determine if System Time between the motion axis device and 
the motion controller is skewed and if so to compensate for the skew. 
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e Controller Time Stamp: This element represents the 64-bit System Time value at the 
beginning of the Controller Update Period when the motion controller’s update timer event 
occurred. It is calculated by the motion controller as the sum of its local clock value when 
update timer event occurred and the motion controller’s System Time Offset value. The 
Controller Time Stamp is therefore directly associated with the command data contained in 
the connection. The value of this element is transferred to the Motion Axis Object class 
attribute of the same name. Taken together with the Controller Update Period and the 
Command Target Time (discussed later), the motion axis device has all the information it 
needs compute command interpolation/extrapolation polynomials to correct command data 
values for differences between the motion axis device and controller update timing. These 
differences can occur when the Controller Update Period is not an integer multiple of the 
Device Update Period or when the motion axis device updates are phase shifted relative to 
the motion controller. 


6-41.5.2.2 Instance Data Blocks 


After the Connection Header are one or more Instance Data Blocks as determined by the above 
Instance Count. The Instance Data Block has the following basic structure: 


Table 6-41.11 Instance Data Block 


Instance Data Block 
Instance Data Header 
Cyclic Data Block 
Event Data Block 


Service Data Block 


6-41.5.2.2.1 Instance Data Header 
The Instance Data Header contains critical axis configuration information needed to parse and 
apply the data contained in the three data channels. This header is only included in the Variable 
Connection format to accommodate multi-axis applications. Information within the header can 
be used by the motion axis device’s communications interface to copy the individual data 
blocks into separate fixed memory locations for processing. 


If configured for a Fixed Connection format, only the Cyclic Data Block for a single axis 
instance is supported so there is no need for any information to specify instance number or 
block sizing. The Instance Data Header is therefore not included. 


Table 6-41.12 Instance Data Header 


Instance Data Header 
Instance Number Reserved Instance Block Size Cyclic Block Size 


Cyclic Actual Block Size | Cyclic Write Block Size Event Block Size Service Block Size 


e Instance Number: This is the number that identifies the specific Motion Axis Object 
instance the following instance data block applies to. Motion Axis Object instances are 
created as a contiguous series of instance numbers starting with instance 1. Within the 
connection data structure the Instance Numbers for each consecutive instance data block 
must be an ordinal sequence, i.e. 1, 2, 3, etc... (Note, instance 0 is defined as the class 
instance and not generally used as part of the connection data.) Thus, in theory, up to 255 
instances can be serviced by the Motion I/O Connection. 
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e Instance Block Size: This value represents the size of the Instance Data Block in 32-bit 
words including the header. The Instance Block Size is useful when the motion axis device 
wants to directly access the next instance data block without having to add the sizes of the 
cyclic, event, and service blocks. 

e Cyclic Block Size: This value represents the size to the Cyclic Data Block in 32-bit word 
units including the header. 

e Cyclic Command Block Size: This value represents the size to the Cyclic Command Data 
Block in 32-bit word units including the header. 

e Cyclic Write Block Size: This value represents the size to the Cyclic Write Data Block in 
32-bit word units including the header. If the Cyclic Write Block Size of 0 indicates, the 
motion axis device does not need to support the Cyclic Read/Write functionality. 

e Event Block Size: This value represents the size to the Event Data Block in 32-bit word 
units including the header. If the Event Block Size is 0, the motion axis device does not 
need to support the event functionality. 

e Service Block Size: This value represents the size to the Service Data Block in 32-bit word 
units including the header. A Service Block Size value of 0 indicates there is no service 
request to process. 


6-41.5.2.2.2 Cyclic Data Block 


The Cyclic Data Header at the top of the Cyclic Data Block is always included regardless of the 
connection format. This header contains key elements related to the content of the Cyclic Data 
Block of both the Controller-to-Device Connection and Device-to-Controller Connection, and, 
the context of the data as determined by the Control Mode and Feedback Configuration. The 
header also provides a mechanism to control the state of the targeted motion axis. 


Table 6-41.13 Cyclic Data Header 


Cyclic Data Header 
Control Mode Feedback Configuration Axis Control - 
Command Data Set Actual Data Set Status Data Set Interpolation Control 
Cyclic Data 


e Control Mode: An 8-bit enumerated value that determines the control mode context of the 
command data as presently configured in the motion controller. This value can be changed 
while on-line and even while the motion axis is in the Running state. If a particular Control 
Mode transition is not supported by the motion axis device, an Illegal Mode Change 
exception is generated that can be configured to perform any one of a number of actions in 
response to the illegal transition. 


The value of this element is transferred to the Motion Axis Object attribute of the same 
name. The complete Control Mode attribute definition can be found in the attribute tables 
in the Motion Axis Object definition in Chapter 5. 


e Feedback Configuration: This 8-bit enumerated value that indicates the feedback context 
of the command data as presently configured in the motion controller. Command data can 
be referenced to feedback counts of either Feedback 1 or Feedback 2, or motor units for 
sensor-less operation. This value can be changed while on-line and even while the motion 
axis is in the Running state. If a particular Feedback Configuration transition is not 
supported by the motion axis device, an Illegal Mode Change exception is generated that 
can be configured to perform any one of a number of actions in response to the illegal 
transition. 
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The value of this element is transferred to the Motion Axis Object attribute of the same 
name. The complete Feedback Configuration attribute definition can be found in the 
attribute tables in the Motion Axis Object definition in Chapter 5. 


e Axis Control: This 8-bit enumerated code that can be used to directly initiate motion axis 
state change operations that do not require either passing or returning motion axis 
parameters, and therefore, do not require a CIP service to initiate. Valid enumerations for 
this data element are shown below: 


Table 6-41.14 Axis Control 


Request Code Requested Operation 


0 No Request 
1 Enable Request 
2 Disable Request 
3 Shutdown Request 
4 Shutdown Reset Request 
5 Abort Request 
6 Fault Reset Request 
7-127 Reserved 
128-255 Vendor Specific 


e Command Data Set: This bit mapped value has a bit defined for each possible real-time 
command reference. Command data appears in the same order in the Command Data Set as 
the bit numbers, so Command Position would appear before Command Torque in the real- 
time data structure of the Controller-to-Device Connection. The value of this element is 
transferred to the Motion Axis Object attribute, Command Data Set. 


Table 6-41.15 Command Data Set 


The above Controller Command Data Elements apply to the Controller-to-Device Connection’s 
cyclic data structure and map to corresponding attributes in the Motion Axis Object as shown 
in the table below. 


The units of the Command Data Elements match the units defined for the associated Motion 
Axis Object attribute. 
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Table 6-41.16 Command Data Element to Motion Axis Object Attribute Mapping 


Bit Motion Axis Object Attribute 
0 Controller Position Command 
1 Controller Velocity Command 
2 Controller Acceleration Command 
3 Controller Torque Command 
6 Acceleration Trim 


It is the job of the motion controller to insure that the necessary Command Data Elements 
are included in the connection data to support the specified Control Mode. 


e Actual Data Set: This bit-mapped value has a bit defined for each possible real-time actual 
data attribute that is to be included in the Actual Data Set of the Device-to-Controller 
connection’s Instance Data Block in the next update. Actual data appears in the same order 
as the bit numbers, so Actual Position would appear before Actual Torque in the Actual 
Data Set structure. Using this mechanism, the contents of the Actual Data Set may be 
changed at any time during motion axis device operation. The value of this element is 
transferred to the Motion Axis Object attribute, Feedback Data Set. 


Table 6-41.17 Actual Data Set 


Bit Actual Data Element Produced Data Type 
Actual Position DINT 
Actual Velocity REAL 
Actual Acceleration REAL 
Actual Torque REAL 
Actual Current REAL 
Actual Voltage REAL 
Actual Frequency REAL 


7 Reserved 


Al usp] wynynyrsio 


The above Actual Data Elements map to corresponding attributes in the Motion Axis 
Object as shown in the table below. The units of the Actual Data Elements match the units 
defined for the associated Motion Axis Object attribute. 


Table 6-41.18 Actual Data Element to Motion Axis Object Attribute Mapping 


Bit Actual Data Element Motion Axis Object Attribute 
Actual Position Position Feedback 

Actual Velocity Velocity Feedback 

Actual Acceleration Acceleration Feedback 

Actual Torque Torque Reference 

Actual Current Iq Current Reference 

Actual Voltage Output Voltage 

Actual Frequency Output Frequency 


NYO] oy RR] WwW] NMNTR|o 


Reserved 
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e Status Data Set: This bit-mapped byte contains flags that determine the contents of the 
Status Data Set of the Device-to-Controller Connection’s Instance Data Block in the next 
update. Status data appears in the same order as the bit numbers, so Drive Fault Status 
would appear before, say, Drive Alarm Status data in the Status Data Set structure. 
Multiple attributes comprising a selected Status Data Element are transmitted in the order 
listed from top to bottom, so Drive Fault Code is transmitted before Mfg Drive Fault Code. 
The definitions of each of these Status Data Elements can be found by looking up the 
corresponding Motion Axis Object attribute in the Motion Axis Object specification. The 
value of this element is transferred to the Motion Axis Object attribute, Status Data Set. 


Table 6-41.19 Status Data Set Configuration 


Bit Status Data Element Produced 
0 Initialization Fault Code 
Initialization Fault Code - Mfg 
Axis Fault Code 
Axis Fault Code - Mfg 
Axis Alarm Code 
Axis Alarm Code - Mfg 
Start Inhibit Code 
Start Inhibit Code - Mfg 
Axis Fault Time Stamp 


1 
2 
3 
4 Axis Status 
Mfg Drive Status 
Axis I/O Status 
Mfg Drive I/O Status 
5 
6 
7 


e Interpolation Control: The byte contains information needed to control the fine 
interpolation algorithm and determine the target time of the command data to the Axis 
Control structure. The value of this element is transferred to the Motion Axis Object 
attribute of the same name. 


Table 6-41.20 Interpolation Control 


0-1 Command Target Time 0 = Immediate 
1 = Extrapolate (+1 Update Period) 
2 = Interpolate (+2 Update Periods) 


6-7 Vendor specific 
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e Command Target Time - This 2-bit integer defines a specific time relative to the 
Connection Time Stamp that the Command Data is targeted for, as defined by the 
controller’s motion planner. The absolute command target time is the sum of the Controller 
Time Stamp from the motion controller and the product, Command Target Time * 
Controller Update Period. 


A Command Target Time of 0 implies that the Command Data is targeted for the beginning 
of the current update cycle and, thus, needs to be applied to the control structure 
immediately. In this case there is no need for any find interpolation. This situation can 
occur when the Controller Update Period is significantly shorter than the Device Update 
Period, or when the controlled motion of the axis is nearly constant during the span of the 
Controller Update Period. 


A Command Target Time of 1 implies the target for the Command Data is the next 
Connection Update timer event. In this case, the command interpolator functions primarily 
as an extrapolator that estimates the next Command Data value based on the present 
trajectory of the axis. This is a typical setting when the Controller Update Period is 
comparable to the Device Update Period or when the controlled motion of the axis is 
relatively constant during the span of the Controller Update Period. 


A Command Target Time of 2 implies the target for the Command Data is two Connection 
Update timer events from the Connection Time Stamp. In this case, the command 
interpolator can compute a smooth trajectory based on the current dynamics of the motor to 
reach the Command Data value at the targeted time. This is true fine interpolation and is 
applicable when the Controller Update Period is significantly larger than the Device 
Update Period. 


e Cyclic Command Data: The Cyclic Command Data contains high priority data that needs 
to be applied to the associated motion axis during the next notion axis update. This block 
consists of command data elements that are applied as references to the motion axis’ 
control algorithms and explicitly determined by the Command Data Set element in the 
Cyclic Command Data Header. 


Cyclic Write Data Block 


The Cyclic Write Data Block can be used to synchronously update one or more targeted 
Motion Axis Object configuration parameters within the device. This mechanism can be used 
in conjunction with a Function Block program to implement sophisticated outer loop control, 
gain scheduling, and dynamic limiting algorithms. Unlike service channel Set Axis Attribute 
service requests, which may take several axis update cycles to process, the Cyclic Write Data 
mechanism guarantees the targeted parameter is applied at the next available axis update. 


The Cyclic Write Data Block is only supported in the Variable Connection format. 


Table 6-41.21 Cyclic Write Data Block 


Cyclic Write Data Block 


Cyclic Write Block ID Cyclic Read Block ID 


Cyclic Write Data 


The associated header for this block contains key elements related to the content of the Cyclic 
Write Data Block. 
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e Cyclic Write Block ID: This 16-bit ID determines the pre-defined Cyclic Write Block 
structure to apply to the Cyclic Write Data for this update. Cyclic Write Block structures 
are defined using the Set Cyclic Write Data List service. A successful response to this 
service includes a new Cyclic Write Block ID that can be used in the next connection 
update to pass cyclic data in this format. The previous Cyclic Write Block ID and its 
associated structure must be maintained until the controller requests transmission of the 
new Cyclic Write Block ID at which point the old Cyclic Write Block ID and structure 
definition are no longer required. 

e Cyclic Read Block ID: This 16-bit ID determines the pre-defined Cyclic Read Block 
structure to apply to the Cyclic Read Data for next Device-to-Controller connection update. 
Cyclic Read Block structures are defined using the Set Cyclic Read Data Block service. A 
successful response to this service includes a new Cyclic Read Block ID that can be used in 
the next connection update to allow the device to use the new Cyclic Read Data format for 
next available Device-to-Controller connection update. 

e Cyclic Write Data: The Cyclic Write Data contains high priority data that needs to be 
applied to the associated motion axis instance during the next axis update. This block 
consists of parametric data elements that are applied to Motion Axis Object attributes that 
are used by the control algorithms. The contents of the Cyclic Write Data are explicitly 
determined by the structure identified by the Cyclic Write Block ID found in the Cyclic 
Write Data Header. 


Event Data Block 


The Event Data Block is used to convey information regarding the event channel. In particular 
the Event Data Block for the Controller-to-Device Connection is used to control the arming of 
event checking functions in the device as well as acknowledge receipt of event notifications 
from the device that are sent via the Device-to-Controller Connection’s Event Data Block. 


The Event Data Block for the Controller-to-Device Connection has the following format. 
Table 6-41.22 Event Data Block 


Event Data Block 
Event Checking Control 


Event Ack. ID 1 Event Ack. Status 1 Event Ack. ID 2 Event Ack. Status 2 


e Event Checking Control: This 32-bit word is copied into the Motion Axis Object attribute 
of the same name that is used to enable various drive inputs, e.g. marker and registration 
inputs, to generate events. When these events occur, the device captures both the time and 
exact axis position when the event occurred. The last 4 bits of the Event Checking Control 
is a binary value that specifies the number of active events, which is literally the number of 
Event Acknowledge IDs listed in this Event Data Block. A complete definition for the 
Event Checking Control attribute can be found in the Motion Axis Object definition in 
Chapter 5. 


The Event Control mechanism works as follows: 


1. Controller sets the appropriate Event Checking bit to look for a specific event condition 
to occur. Multiple bits in the Event Checking Control word may be set at any given 
time. 
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Drive detects the Event Checking Control request bit is set and initiates the requested 
event checking action. 


Drive sets the corresponding Event Checking Status bit to acknowledge that the device 
is now actively checking for the specified event condition. 


Controller sees the Event Checking Status bit from the device is set indicating that 
specified event trigger is “armed” at the device. Starting with this update the controller 
can process any event notifications from the device that match the specified event 
condition. 


Motion axis device detects the specified event condition, increments the Event ID, and 
sends an Event Notification Data Block with this ID to the controller. If the associated 
Auto-rearm bit is clear in the Event Checking Control word, the device discontinues 
checking for the specified event. However, the Event Checking Status bit remains set 
until the Event Checking Request bit is cleared by the motion controller. Note that 
notifications for other events can be sent in the same update. 


Motion controller processes the Event Notification, sends the Event Acknowledge to the 
device and, if Auto-rearm is not enabled, clears the associated Event Checking bit for 
the next Controller-to-Device connection update. 


Motion axis device detects the Event Checking Request bit is clear and clears the 
corresponding Event Checking Status bit prior to the next Device-to-Controller 
connection update. 


Controller is able to set the Event Checking bit again as soon as it sees the associated 
Event Checking Status bit has been reset. So, the minimum time between when the 
Event Notification was received by the controller to the time when the device is 
rearmed for the next event is one Controller Update Period. 


In the case of a Registration event where Auto-rearm Event Checking is requested, the event 
handling sequence is as follows: 


1. 


Motion controller sets the appropriate Event Checking bit to look for a specific event 
condition to occur and also sets the Auto-rearm bit for that event condition. 


Motion axis device detects the Event Checking Control request bit is set and initiates 
the requested event checking action. 


Motion axis device sets the corresponding Event Checking Status and Auto-rearm bits 
to acknowledge that the device is now actively checking for the specified event 
condition. 


Motion controller sees the Event Checking Status bit from the motion axis device is set 
indicating that specified event trigger is “armed” at the device. Starting with this update 
the motion controller can process any event notifications from the device that match the 
specified event condition. 
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Motion axis device detects the specified event condition, increments the Event ID, and 
sends an Event Notification Data Block with this ID to the motion controller. Since the 
corresponding Auto-rearm bit is set, the device continues checking for the specified 
event. The Event Checking Status bit remains set until the Event Checking Request bit 
is cleared by the motion controller. If the dvice detects another specified event condition 
prior to transmission of the first event to the controller, it increments the Event ID 
again, and append another Event Notification with this ID to the Event Data Block to 
the motion controller. Since the corresponding Auto-rearm bit is set, the 
devicecontinues checking for the specified event. 


Motion controller processes the Event Notification, sends the Event Acknowledge to the 
device but, since the Auto-rearm bit is enabled, it leaves the associated Event Checking 
bit set for the next Controller-to-Device connection update. 


Motion axis device receives the Event Acknowledge from the motion controller. It can 
now send another Event Notification if the specified event has occurred again. 
Otherwise... 


Motion axis device continues checking for the specified event condition and sends an 
Event Notification Data Block to the controller whenever the event condition occurs. 
The Event Checking Status bit remains set until the Event Checking Request bit is 
cleared by the motion controller. With the Auto-rearm feature, event checking is 
continuously enabled, insuring that no registration events are missed during the normal 
one cycle delay in re-arming the event checking mechanism. The down side of Auto- 
rearm feature is that it can generate a multitude of uninteresting events to process, in 
fact, multiple specified events per Controller Update Period. Therefore, these events 
must either be buffered in the motion controller in an event array attribute or filtered 
based on the event data. The later case is how Windowed Registration functionality is 
implemented; the Windowed Registration feature checks each registration event that 
arrives from the motion axis device to see if the Event Position yields an absolute 
position value that is within the configured Registration Window. If the computed 
registration position is outside the window, the event is thrown away. If the computed 
registration position is within the window the registration position and registration time 
stamp is stored in the motion controller. 


Event Acknowledge ID: Transaction number assigned to this event by the original event 
notification. Each event is assigned a new Event ID by incrementing the current Event ID 
stored in the motion axis device. Using the Event ID, the device is able to match the event 
acknowledgement to the appropriate event notification to complete the event data 
transaction. 

Event Acknowledge Status: Enumerated value indicating motion controller response to 
the event. A value of 0 indicates that the event was successfully processed. A non-zero 
value indicates that an error occurred in the event processing and the event must be resent. 


Service Data Block 


The service data block allows one service request per instance to be sent to the motion axis 
device in a given update. The service request requires a specific service response from the 
device indicating success or an error. In some cases the response service contains requested 
data. In any case, the service request data persists in the Controller-to-Device Connection data 
structure until the controller receives the associated service response from the device. 
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Each service request is represented by a block of data organized as shown below. 


Design Note: By design, of the first 4 bytes of the service data block do not follow the 
traditional CIP standard messaging format. That is primarily because this connection structure 
is, fundamentally, a CIP Implicit I/O connection, not an Explicit Messaging connection. 
However, in the case of a Fixed Connection format, the Service Specific Request Data defined 
below is sent via an Explicit Messaging connection and follows the CIP rules for explicit 
service request format 


Table 6-41.23 Service Data Block 


Service Data Block 


Service Specific Request Data 

e Transaction ID: Transaction number assigned to this service request by the motion 
controller. Each service request is assigned a new Transaction ID by incrementing the 
current Transaction ID stored in the controller. Using the Transaction ID, the controller is 
able to match the service response to the appropriate service request and complete the 
service transaction. 

e Service Code: Identifier that determines the object specific service request that follows. 
The list of supported Service Codes can be found in the Object Specific Services section of 
this document. CIP Common services are not applicable to the Service Data Block. 

e Service Specific Request Data: The format and syntax of the Service Specific Request 
Data depends on the specified Service Code. This is true regardless of whether the service 
specific request data is passed in the Controller-to-Device connection or as part of an 
Explicit messaging connection. 


Device-to-Controller Connection 
Like the Controller-to-Device Connection data structure described above, the Device-to- 
Controller Connection is organized as follows: 


Table 6-41.24 Motion Device-to-Controller Connection Format 


Motion Device-to-Controller Connection Format 
Connection Header 


Instance Data Blocks 


Device-to-Controller Connection Header 


The Device-to-Controller Connection Header contains critical axis configuration information 
needed to parse the Device-to-Controller connection data block. The fixed portion of the 
connection header is defined as follows: 


Table 6-41.25 Connection Header 


Connection Header 


Connection Format Update ID Node Status 
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Connection Format: Same as Controller-to-Device definition except the required value 
for the Connection Type is either 3, indicating a Fixed Device-to-Controller connection 
type or 7, indicating a Variable Device-to-Controller connection type. 


O = Reserved 

1 = Reserved 

2 = Fixed Controller-to-Device Connection 

3 = Fixed Device-to-Controller Connection 

4 = Reserved 

5 = Reserved 

6 = Variable Controller-to-Device Connection 
7 = Variable Device-to-Controller Connection 
8-15 = Reserved 


Format Revision: The Format Revision number is 1 for any device that utilizes this 
version of the specification. This value is to be incremented by 1 for every revision of the 
Device-to-Controller Connection format that impacts the interface. The Format Revision 
allows newer controllers to support the connection formats generated by older drives. It 
also allows older controllers to recognize a newer connection format from a drive that it 
cannot support and generate an appropriate error to its application. 

Update ID: The Device-to-Controller connection Update ID should match the Update ID 
of the preceding Controller-to-Device Update ID and therefore must be incremented every 
update period. In the case where the associated Controller-to-Device packet is lost or late, 
the Device-to-Controller Update ID must be incremented as if the Controller-to-Device 
packet had arrived on time. This allows the motion control system to ride through a lost or 
missed Controller-to-Device packet and maintain synchronization with matching Update 
IDs. 


The Update ID is like the CIP message sequence count and is used by the motion controller 
to determine whether the connection buffer contains fresh data. If the Update ID has not 
changed, the controller attempts to ride through the missed update by extrapolation based 
on previous trajectory until a fresh update arrives. In the case where the axis is not 
synchronized, or does not support time synchronization services, the time stamp data is 
either not included or invalid, so no ride through extrapolation is attempted. In that case, 
the Update ID is also the only way for the controller to detect new connection data. 


Node Status: Contains bits used to indicate the status of the associated motion axis device. 
The value of this element is derived from the Motion Axis Object class attribute of the 
same name. For details refer to the Motion Axis Object. 


Fixed Connection Header 


If the Connection Format is a Fixed Device-to-Controller Connection the above header is 
immediately followed by the instance data block. 


6-41.5.3.1.2 


Variable Connection Header 


If the Connection Format is a Variable Device-to-Controller Connection then the connection 
header contains additional fields related to multi-axis addressing and time stamping. 
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Table 6-41.26 Connection Header 


Connection Header 


Connection Format Update ID Node Control 
Instance Count Node Alarms Node Faults Time Config 


Device Update Period 
Device Time Offset 
Device Time Stamp 

Data Received Time Stamp 
Data Transmit Time Stamp 
Sync Variance 


e Instance Count: Same as Controller-to-Device definition. 

e Node Alarms: Contains bits used to indicate the alarm conditions of the associated motion 
axis device. The value of this element is derived from the Motion Axis Object class 
attribute of the same name. For details refer to the Motion Axis Object. 

e Node Faults: Contains bits used to indicate the fault conditions of the associated motion 
axis device. The value of this element is derived from the Motion Axis Object class 
attribute of the same name. For details refer to the Motion Axis Object. 

e Time Data Set: Same as Controller-to-Device definition. 

e Device Update Period: This element represents the current period between motion axis 
control calculations that apply the command data. This value is used by the motion 
controller to configure the behavior of the fine interpolation blocks that are applied to the 
command data. If the Controller Update Period is much longer than the Device Update 
Period, fine interpolation is generally applied. When the Controller Update Period is 
comparable to the Device Update Period, fine interpolation is unnecessary and only 
extrapolation is required to perform time stamp corrections. 

e Device Time Offset: This element represents the 64-bit System Time Offset value 
associated with the Device Time Stamp that follows. The Device Time Offset value is used 
by the motion controller to determine if System Time as defined in the motion axis device 
is skewed relative to System Time in the controller. Normally, System Time between the 
motion axis device and the motion controller are closely matched at any given time. But 
every few seconds, according to the IEEE-1588 protocol, the time master of the system can 
correct the System Time reference, sometimes by a significant amount of time, perhaps as 
much as an hour. Indeed, even the master itself can change as a higher quality time master 
is discovered by the system. These step changes to the System Time reference propagate 
through to the various devices on the network in such a way that the motion controller and 
the motion axis device are running with skewed System Time values. The Device Time 
Offset value can be used together with the System Time Offset for the motion controller to 
both determine if System Time between the motion axis device and the motion controller is 
skewed and if so to compensate for the skew. 
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e Device Time Stamp: This time stamp value represents the 64-bit System Time value, in 
nanoseconds, when the motion axis’ update timer event occurred that is associated with the 
actual data in the connection structure, e.g. when the actual data was captured. It is 
calculated by the motion axis device as the sum of the its local clock value when update 
timer event occurred and the device’s System Time Offset value. With the Device Time 
Stamp, the motion controller has all the information it needs to correct actual data values 
for differences between the motion axis device and motion controller update timing that 
result when the Controller Update Period is not an integer multiple of the Device Update 
Period or when the device updates are phase shifted relative to the controller. It is assumed 
in this timing model that the Device Time Stamp is registered to the beginning of the 
Device Update Period and is also the time when feedback was last captured. In the case 
where the Device Time Stamp does not match the local update time stamp of the motion 
controller, the controller extrapolates the actual response data value based on trajectory to 
correspond to the controller’s time stamp. The timing diagram below illustrates how axis 
position data from the motion axis device is adjusted by the motion controller based on the 
relative time stamps between the motion axis device and the controller. 


Figure 6-41.3 Adjustment of Actual Position Data based on Device Time Stamp 
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Data Received Time Stamp: This element represents the 64-bit System Time value at the 
moment that the last Control-to-Device connection data arrived at the motion axis device and 
was ready for processing. The time stamp units are nanoseconds. This value, when combined 
with the motion controller’s corresponding data transmit time stamp, can be used by the motion 
controller to generate Control-to-Device connection data delivery statistics. 


Data Transmit Time Stamp: This element represents the 64-bit System Time value at the 
moment that the Device-to-Controller connection data is transmitted to the motion controller. 
The time stamp units are nanoseconds. This value, when combined with motion controller’s 
corresponding data received time stamp, can be used by the controller to generate Device-to- 
Controller connection data delivery statistics. 


Sync Variance: This element represents the current statistical variation of the System Time 
Offset value from the mean System Time Offset value. 


Instance Data Blocks 


After the Connection Header are one or more Instance Data Blocks as determined by the above 
Instance Count. The Instance Data Block is very similar to that of the Controller-to-Device 
Connection and has the following basic structure: 
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Table 6-41.27 Instance Data Block 


Instance Data Block 
Instance Data Header 
Cyclic Data Block 
Event Data Block 


Service Data Block 


6-41.5.3.2.1 Instance Data Header 
The Instance Data Header contains critical axis configuration information needed to parse and 
apply the data contained in the three data channels. This header is only included in the Variable 
Connection format to accommodate multi-axis applications. Information within the header can 
be used by the drive communications interface to copy the individual data blocks into separate 
fixed memory locations for processing. 


If configured for a Fixed Connection format, only the Cyclic Data Block for a single axis 
instance is supported so there is no need for any information on instance number or block 
sizing. Hence, the Instance Data Header is not included in the connection structure. 


Table 6-41.28 Instance Data Header 


Instance Data Header 


Instance Num aa eee) Instance Block Size Cyclic Block Size 


Cyclic Actual Block Cyclic Read Block Size Event Block Size Service Block Size 
Size 


e Instance Number: Same as Controller-to-Device definition 

e Instance Block Size: Same as Controller-to-Device definition. 

e Cyclic Block Size: Same as Controller-to-Device definition. 

e Cyclic Actual Block Size: Same as Controller-to-Device definition. 
e Cyclic Read Block Size: Same as Controller-to-Device definition. 
e Event Block Size: Same as Controller-to-Device definition. 

e Service Block Size: Same as Controller-to-Device definition. 


6-41.5.3.2.2 Cyclic Data Block 


The Cyclic Data Header at the top of the Cyclic Data Block of the Device-to-Controller 
Connection is always included regardless of the connection format. This header contains key 
elements related to the content of the Cyclic Data Block and the context of the data within the 
block with respect to the motion axis device. Most of these elements are established by, and are 
therefore direct copies of, corresponding elements of the previous Controller-to-Device 
Connection Cyclic Data Block. Thus, the content of the Cyclic Data Block for the Device-to- 
Controller Connection is ultimately determined by the motion controller. 


Table 6-41.29 Cyclic Data Block 


Cyclic Data Block 


Control Mode Feedback Config Response Status 
- Actual Data Set Axis State 


Cyclic Command Data 


Cyclic Actual Data 
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Cyclic Data Block 

Cyclic Status Data 
Control Mode: Same as Controller-to-Device definition. 
Feedback Config: Same as Controller-to-Device definition. 


Axis Response: The 8-bit Device Response is an enumerated value that is used for 
handshaking with the corresponding Device Control element of the Controller-to-Device 
Connection to directly initiate motion axis operations that do not require a CIP service 
request. Valid Acknowledge Codes match the corresponding Request Codes of the Axis 
Control element, and are shown below: 


Table 6-41.30 Axis Response 


Acknowledge Code Axis Response 
0 No Acknowledge 
1 Enable Acknowledge 
2 Disable Acknowledge 
3 Shutdown Acknowledge 
4 Shutdown Reset Acknowledge 
5 Abort Acknowledge 
6 Fault Reset Acknowledge 
7-127 Reserved 
128-255 Vendor Specific 


This Axis Control/Axis Response mechanism for initiating state changes is fully described in 
the State Control section of the Motion Axis Object. 


Response Status: When there is a non-zero Acknowledge Code in the Axis Response, a 
Response Status value is also provided to indicate success or failure of the requested Axis 
Control operation. A Response Status of 0 indicates success, while a non-zero value 
indicates an error. The Response Status values comply with CIP general Status Codes. 
Command Data Set: Same as Controller-to-Device definition. 

Actual Data Set: Same as Controller-to-Device definition. 

Status Data Configuration: Same as Controller-to-Device definition. 

Axis State: This data element contains the enumerated Axis State value indicating the 
current state of this motion axis instance according to the Motion Axis Object State Model. 
Cyclic Actual/Status Data: The Cyclic Actual/Status Data contains high priority data that 
needs to be applied to the associated motion axis instance during the next motion axis 
device update. This block consists of actual data elements and status data elements that are 
consumed by the motion controller as explicitly determined by the Actual Data Set and the 
Status Data Set elements in the Cyclic Data Header. See Controller-to-Device definition for 
details of Cyclic Actual/Status Data structure. 
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Cyclic Read Data Block 


The Cyclic Read Data Block can be used to synchronously update one or more targeted 
Controller Axis Object attributes within the motion controller based on the current value of 
associated attributes in the motion axis device. This mechanism can be used in conjunction 
with, for example an IEC-1131based Function Block program, to implement sophisticated 
outer loop control based on a wide variety of available motion axis control signals. Unlike 
service channel Get Axis Attribute service requests, which may take several axis update cycles 
to process, the Cyclic Read Data mechanism guarantees the targeted parameter is updated every 
connection cycle. 


The Cyclic Read Data Block is only supported in the Variable Connection format. 
Table 6-41.31 Cyclic Read Data Block 


Cyclic Read Data Block 


Cyclic Read Block ID - 


Cyclic Read Data 


The associated header for this block contains key elements related to the content of the Cyclic 
Write Data Block. 


e Cyclic Read Block ID: This 16-bit ID determines the pre-defined Cyclic Read Block 
structure to apply to the Cyclic Read Data for this update. Cyclic Read Block structures are 
defined using the Set Cyclic Read Data List service. A successful response to this service 
includes a new Cyclic Read Block ID that can be used in the next connection update to 
pass cyclic data in this format. 

e Cyclic Read Data: The Cyclic Read Data contains high priority data that needs to be 
applied to the associated controller axis instance. This block consists of signal and status 
data elements that are to be scaled and applied to corresponding Motion Axis Object 
attributes. The contents of the Cyclic Read Data are explicitly determined by the structure 
identified by the Cyclic Read Block ID found in the Cyclic Read Data Header. 


Event Data Block 


The Event Data Block allows multiple event notifications to be sent to the motion controller in 
a given update. Each event notification requires a specific event acknowledge indicating 
success or an error. The event notification data persists in the Device-to-Controller Connection 
data structure until the drive receives the corresponding event acknowledgement from the 
motion controller. 


The Event Data Block for the Device-to-Controller Connection has the following format. 


Table 6-41.32 Event Data Block 


Event Data Block 
Event Checking Status 
Event Position 


Event Time Stamp 
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e Event Checking Status: This 32-bit word is a bit mapped parameter used to indicate if the 
motion axis device is currently checking for events based on various device inputs, e.g. 
marker, home, and registration inputs. Event checking is initiated when the corresponding 
Event Checking Control bit is set in the Controller-to-Device connection. When an event 
occurs, the motion axis device captures both the time and exact axis position and passes 
this information to the motion controller in event data blocks. But for the controller to 
process the event data, the corresponding event checking status bit must be set. For more 
detail on how this word is used in event operations, refer to the event mechanism sequence 
in the Motion Axis object model in Chapter 5. A complete definition for the Event 
Checking Status attribute can be found in the Motion Axis object definition in Chapter 5. 

e Event ID: Transaction number assigned to this event by the original event notification. 
Each event is assigned a new Event ID by incrementing the current Event ID stored in the 
motion axis device. Using the Event ID, the device is able to match the event 
acknowledgement to the appropriate event notification to complete the event data 
transaction. 

e Event Status: Enumerated value indicating motion controller response to the event. A 
value of 0 indicates that the event was successfully processed. A non-zero value indicates 
that an error occurred in the event processing and the event must be resent. 

e Event Type: This enumerated value describes the type of event that occurred. Valid event 
types are as follows: 


Table 6-41.33 Event Type 


Event Type Event Description 
0 Registration 1 Positive Edge 

Registration 1 Negative Edge 

Registration 2 Positive Edge 

Registration 2 Negative Edge 

Marker Positive Edge 

Marker Negative Edge 

Home Switch Positive Edge 

Home Switch Negative Edge 


Home Switch-Marker ++ 


OLSON a! om] BR] WwW] NtrR 


Home Switch-Marker +- 
10 Home Switch-Marker -+ 
11 Home Switch-Marker -- 
12-127 Reserved 
128-256 Vendor specific 

e Event Position: 32-bit integer representation of the axis position when the designated 
event occurred. 

e Event Time Stamp: This element represents the 64-bit System Time value when the 
specified event occurred. The time stamp units are nanoseconds. Taken together with 
motion axis device’s System Time Offset value that is part of the Device-to-Controller 
connection header, the motion controller has all the information it needs compute the 
absolute System Time when the event occurred 
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Service Data Block 


The service data block allows one service response per instance to be sent to the motion 
controller in a given update. Each service request requires a specific service response from the 
motion axis device indicating success or an error. In some cases the response service contains 
requested data. In any case, the service response data persists in the Device-to-Controller 
Connection data structure until the device sees the associated service request removed from the 
Controller-to-Device connection instance data block (Service Block Size = 0) or a new service 
request is issued by the controller (incremented Transaction ID). 


Each service response is represented by a block of data organized as shown below. 


Design Note: Like the request structure, the structure of the service response does not follow 
the standard CIP explicit messaging format. That is primarily because this connection structure 
is, fundamentally, a CIP Implicit I/O connection, not an Explicit Messaging connection. 
However, the case of a Fixed Connection format, the Service Specific Request Data defined 
below is sent via an Explicit Messaging connection and follows the CIP rules for explicit 
service request format. 


Table 6-41.34 Service Data Block 


Service Data Block 


Service Specific Response Data 


e Transaction ID: Transaction number assigned to this service response derived from the 
Transaction ID of the original request. Each service request is assigned a new Transaction 
ID by incrementing the current Transaction ID stored in the motion controller. Using the 
Transaction ID in the response, the controller is able to match the service response to the 
appropriate service request. 

e Service Code: Identifier that determines the specific service response that follows which 
should match the Service code of the originating service request. A list of valid Service 
Codes for the Motion Axis Object is given in the Controller-to-Device section. 

e General Status: The General Status value is provided to indicate success or failure of the 
requested service request. A General Status of 0 indicates success, while a non-zero value 
indicates an error. The General Status values follow the CIP standard for General Status 
codes. 

e Extended General Status: The Extended General Status provides a method for defining 
vendor specific or service specific error codes. There is currently no standard definition for 
these codes. 

e Service Specific Response Data: The format and syntax of the Service Specific Response 
Data depends on the specified Service Code. 
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Fixed Drive Connection Format 


By specifying a Fixed Connection Format, the Motion I/O Connection can be reduced to a size 
that is readily applicable to other CIP Networks like DeviceNet and ControlNet. In the context 
of a DeviceNet or ControlNet network the following features have been removed from the 
connection structure to support the requirements of a fixed connection size and limited network 
bandwidth. 

e Time Stamping 

e Node Faults/Alarms 

e One Instance Only 

e Dynamic Block Sizing 

e Cyclic Read/Write Data Block 

e Event Data Block 

e Service Data Block 

With Fixed Connection Format, service requests to the Motion Axis Object are supported only 
as an Explicit Messaging service. 


Below is an illustrative example of the Fixed Connection Format being used in a simple 
variable speed drive application requiring only a velocity command and returning actual 
velocity. In this case, the connection size has been reduced to 16-bytes, a size that is well suited 
for a network like DeviceNet. 


Table 6-41.35 Fixed Controller to Device Connection Format (fixed size = 16 bytes) 


Controller to Device Connection Structure 


Connection Format Update ID Node Control 


Control Mode Feedback Axis Control - 
Configuration 
Command Data Set Actual Data Set - 


Command Velocity 


Table 6-41.36 Fixed Device to Controller Connection Format (fixed size = 16 bytes) 


Device to Controller Connection Structure 


Connection Format Update ID Node Status 


Control Mode Feedback Axis Response Response Status 
Configuration 


- Actual Data Set Axis State 


Actual Velocity 


Motion Connection Timing 


The general timing model for motion I/O connection data exchange is described in this 
following section. Data exchange between the drive and the controller is paced by the 
controller with one Device-to-Controller data packet sent for every Controller-to-Device data 
packet received. The Controller-to-Device connection packets are sent periodically according 
to the configured Controller Update Period. The Device Update Period, i.e. the update period at 
which the drive performs its control calculations, is typically much faster than the Controller 
Update Period. The basic motion connection timing model is illustrated in the following 
diagram: 
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Figure 6-41.4 Motion Connection Timing Model 
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The basic motion connection sequence consists of 5 basic steps, which are shown in the 
diagram and described as follows: 


1. 


A Motion Axis Device Interrupt Service begins in response to a periodic Motion Axis 
Device Timer Event and the drive determines that a Coarse Update transmission to the 
motion controller is required. The motion axis device computes the Actual Position value 
(assuming Position Control Mode in this example) based on feedback count value captured 
in synchrony with the interrupt service timer event. 


Once the Actual Position Input Data is loaded into the Device-to-Controller connection 
structure, the motion axis device transmits the data to the motion controller. The Input Data 
packet traverses the network and arrives at the motion controller prior to the start of the 
phase delayed Controller Task. 


After a predetermined Phase Offset time from the start of last Controller Timer Event, 
which is typically set to be around 1/3 of the Coarse Update Period, the Controller Task 
starts. The task begins by reading the Actual Position Input Data from motion axis device. 
The motion controller then runs a Motion Planner to compute a new Command Position 
value to send back to the motion axis device. When gearing or camming operations are 
active it may be necessary to use the Actual Position of a master axis as input to compute 
the Command Position of one or more slave axes. 
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4. Once the Command Position Output Data is loaded into the Controller-to-Device 
Connection structure, the controller transmits the data to the motion axis device. The 
Output Data packet traverses the network and arrives at the motion axis device prior to the 
start of the next Coarse Update Period. 


5. The next Drive Interrupt Service begins and the motion axis device determines that it has 
received fresh Output Data from the motion controller. The motion axis device then reads 
the Command Position Data and applies the data along with the time stamp to the device’s 
fine interpolator/extrapolator. 


While other timing models are possible based on the motion controller configuration, all 
applicable motion timing models begin with the motion axis device sending actual data to the 
motion controller at the beginning of the Controller Update Period and end with command data 
arriving before the next Controller Update Period. However, it is not required that the 
command data sent to the motion axis device in a given update period be the result of 
calculations performed during that period. 


Most motion control protocols require the Controller Update Period to be an integer multiple of 
the Device Update Period. But because the Motion I/O Connection packet includes a Time 
Stamp, the update period of the controller does not need to have any fixed relationship with the 
update period of the motion axis device. 


Controller-to-Device Connection Timing 


The Motion I/O Connection data exchange is initiated by the motion controller via the 
Controller-to-Device Connection packet. The inclusion of Time Stamp and Time Offset 
information along with the command data in this packet relieves the stringent timing 
requirements imposed by other motion control network protocols. The following diagram 
illustrates how command data and time stamps delivered by the Controller-to-Device 
Connection are applied to the motion axis when fine interpolation is required. 
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Figure 6-41.5 Controller-to-Device Connection Timing with Fine Interpolation 
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The following steps describe in detail how connection data is transferred from the controller to 
the device for fine interpolation during a typical connection cycle in the general case where the 
Controller Update Period (CUP) is not an integer multiple of the Device Update Period. 


1. Controller Transmit: As part of the Control Task, the motion controller initiates 
transmission of a Controller-to-Device Connection packet with new command data to the 
targeted motion axis device with an incremented Update ID and a new Controller System 
Time Stamp and Controller System Time Offset referencing the system time at the start of 
the current Controller Update Period. The instance data block for the targeted axis also 
contains the Command Target Time, which in this example is set to +2 to account for the 
one Controller Update Period (CUP) transport delay and the one Controller Update Period 
(CUP) delay for fine interpolation. 


2. Command Update ID Check: The motion axis device runs a periodic Drive Task that 
checks every Device Update Period for new Controller-to-Device Connection packet data. 
This can be easily done by checking for a changed Update ID. If the Drive Task discovers 
fresh data, then this is a command data update cycle and the command data must be further 
processed according to the following sequence. 
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3. Synchronous Operation Check: Next, the motion axis device checks if it is synchronized. If 
not synchronized, skip to the Apply Command Data step since there is no need to perform 
the System Time Offset Check or the Late Update Check. Bypassing these checks allows 
for control of the motion axis device during start-up or even in the case where the device 
does not have any time synchronization services. 


4. System Time Offset Check: Synchronous operation requires that System Time between the 
motion axis device and the motion controller match to make the time stamps exchanged 
between the devices meaningful. Since System Time can be adjusted at any time by the 
time master and the adjustments can propagate to the different devices in the network at 
different times, it is possible for System Time between the controller and the motion axis 
device to be skewed. This skew must be detected and, if present, the motion axis device 
must adjust the Controller Time Stamp to compensate for the skew. For details of this 
algorithm refer to the section entitled “Compensation Algorithm for Timestamps Within a 
Single Node” in the Time Sync Object definition in chapter 5. 


5. Late Update Check: Assuming synchronous operation, the motion axis device computes the 
difference between the current drive update time stamp and the Controller Time Stamp 
passed in the Controller-to-Device Connection packet Stamp (adjusted, if necessary). If the 
difference is greater than Controller Update Delay High Limit * Controller Update Period, 
the drive throws a Controller Update Fault. Note that if the time difference has exceeded 
twice the Connection Update Period, the current fine interpolator polynomial has become, 
effectively, an extrapolator polynomial allowing the motion axis to ride through the late 
data condition until the new data arrives. 


6. Apply Command Data: Assuming synchronous operation and a Command Target Time of 
+2 for fine interpolation, the motion axis device computes coefficients for the fine 
interpolation polynomial based on the command reference being applied at the computed 
Target Time, which is the sum of the (adjusted) Controller Time Stamp (CUP), Tctr1, and 
the product of the Command Target Time and Controller Update Period, or in this case, 2 * 
CUP. If the Target Time is less than the current System Time in the motion axis device, 
new coefficients to the polynomial are still computed based on this command data to 
improve the accuracy of the extrapolation calculations. In general, whenever command data 
is late, the data still represents the freshest command data available and must be applied as 
soon as possible. If asynchronous operation, the command data is applied to the motion 
axis control structure immediately. 


7. Schedule Next Device-to-Controller Update: Assuming synchronous operation, the motion 
axis device schedules the time to send the next Device-to-Controller Connection packet to 
the controller. This transmission time target is the sum of the (adjusted) Controller Time 
Stamp, Tctrl, plus the Controller Update Period (CUP). Since, in this general case, the 
Controller Update Period is not an integer multiple of the Device Update Period, the 
transmission time target must be in the form timing window, defined as the Actual Update 
Window, that spans 1 Device Update Period and ends at the computed time of the next 
Controller Update. If asynchronous operation, the motion axis device simply proceeds to 
transmit the next Device-to-Controller Connection packet. 


8. Follow Device-to-Controller Timing sequence in section 6-41.5.5.2. 
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If the Command Target Time is set to +1, the computed polynomial in step 6 is not applied for 
the purpose of fine interpolation but rather for extrapolation; the extrapolation polynomial 
allows the motion axis device to compute an accurate command data value at the time the 
device performs its control calculations based on previous axis trajectory. The diagram below 
illustrates this timing model in the general case where the Controller Update Period (CUP) is 
not an integer multiple of the Drive Update Period. 


Figure 6-41.6 Controller-to-Device Connection Timing with Unequal Update Periods 
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Note in the above example there are not many Device Update Periods in a given Controller 
Update Period. When this is the case, fine interpolation is not critical to motion axis 
performance and command data can be applied more directly to the motion axis’ control 
structure without the extra delay required to support fine interpolation. Extrapolation has the 
disadvantage however that extrapolation error is manifested more directly to the command data 
resulting in rougher motion than when using fine interpolation. 


All cyclic data associated with the Controller-to-Device Connection packet must be applied in 
the Drive Task command update to make the earliest possible use of fresh command data, 
computing new interpolation/extrapolation polynomial coefficients. 


— 6-281 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 6: Device Profiles, Part 5 


6-41.5.5.2 


CIP Motion Drive, Type: 25hex 


Device-to-Controller Connection Timing 


When in synchronous mode, the Motion Device-to-Controller Connection includes a Device 
Time Stamp (and Device Time Offset) with the actual data to allow the motion controller to 
determine the position of the motion axis at the time the Controller Task update occurs. Time 
stamping allows the motion axis device to sample feedback and compute actual data values 
based on its own Device Update Period that, unlike other motion control network protocols, 
does not need be strictly related to the Controller Update Period. The following diagram 
illustrates how actual data and time stamps delivered by the Device-to-Controller Connection 
are used to adjust motion axis actual position, for example, to the motion controller’s timebase. 


Figure 6-41.7 Use of Time Stamp to Adjust Actual Position to the Controller’s Timebase 
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The following steps describe in detail how connection data is transferred from the motion axis 
device to the motion controller during a typical connection cycle in the general case where the 
Controller Update Period (CUP) is not an integer multiple of the Drive Update Period. This 
sequence of steps begins where the Controller-to-Device description ends as detailed in the 
previous section. 
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1. Actual Update Window Check: If the axis is synchronized, the motion axis device 
compares current Drive Task time stamp with the Actual Update Window that is 
determined during the last command data update. The Actual Update Window has duration 
of 1 Device Update Period and ends at the computed time of the next Controller Update. If 
the Drive Task time stamp is within the time window, this is an actual data update cycle. If 
the time stamp is before the window, then the motion axis device must wait for a 
subsequent Drive Task to send the actual data to the controller. (This prevents a condition 
where there is excessive time between the feedback capture and the start of the next 
Controller Task.) If the axis is not synchronized and it has just received a command update 
via the Controller-to-Device Connection, then this is also an actual update cycle, so move 
on to the Drive Transmit step. 


2. Drive Transmit: If this is an actual update cycle, then the motion axis device sends the 
Device-to-Controller Connection packet to the motion controller with the latest Actual 
Data from this Drive Task, including, if synchronized, the current Device Time Stamp (and 
Device Time Offset), and an incremented Update ID. If not synchronized, just send the 
Update ID of the preceding Controller-to-Device Connection packet. All additional data 
sent to the motion controller in this packet may be derived from the previous Drive Task. 
This allows the drive transmission to occur at the earliest point in the Drive Task execution. 


3. Actual Update ID Check: In the next Controller Task, the motion controller checks for new 
data from the drive by checking for a changed Update ID. The following steps are 
performed regardless of whether on not the Update ID has changed. Note that the Update 
ID is the only way to detect for new actual data when the motion axis device is not 
synchronized. 


4. Sync Flag Check: Motion axis device checks the Sync Mode bit of the Drive Node Status 
byte to determine if the motion axis is synchronized. If not, skip to the Apply Actual Data 
step to avoid Late Update checking and Time-Stamp Correction. Bypassing these 
subsequent steps allows the motion axis to operate during start-up or even in the case 
where the motion axis device does not have any time synchronization services. 


5. System Time Offset Check: Synchronous operation requires that System Time between the 
motion axis device and the motion controller to match to make the time stamps exchanged 
between the devices meaningful. Since System Time can be adjusted at any time by the 
time master and the adjustments can propagate to the different devices in the network at 
different times, it is possible for System Time between the controller and the motion axis 
device to be skewed. This skew must be detected and if present, the motion axis device 
must adjust the Device Time Stamp to compensate for the skew. For details of this 
algorithm refer to the section entitled “Compensation Algorithm for Timestamps Within a 
Single Node” in the Time Sync Object definition in chapter 5. 


6. Late Update Check: The motion controller computes the difference between the current 
Connection Update Period time stamp and the Time Stamp in the Device-to-Controller 
Connection packet. If the difference is greater than Missed Update Tolerance * Update 
Period, the controller throws a Controller Sync Fault. 
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7. Time-Stamp Correction: If the previously computed time difference is non-zero, then 
extrapolate the actual data value based on previous axis actual trajectory to line up with the 
controller’s time stamp. This correction is necessary because the motion planner assumes 
that actual input data is implicitly time stamped to the beginning of the Controller Update 
Period. 


8. Apply Actual Data: Controller applies actual data as inputs to the motion planner, which 
computes new command reference data for the next Controller-to-Device update. 


Device Update Period Independence 


The timing diagram below illustrates how two motion axes can be tightly coordinated despite 
having different Device Update Periods and despite having an associated Controller Update 
Period that is not an integer multiple of either Device Update Period. 


Figure 6-41.8 Coordination of Two Drives with Different Update Periods. 
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In the above timing diagram, the controller’s motion planner task sends identical command 
positions and time stamps to two slave motion axes that, while synchronized with System 
Time, are running at different motion axis update rates. When the command position data 
arrives at the two devices, they use the Controller Time Stamp, the Command Target Time, and 
the Controller Update Period to compute new coefficients to the interpolation polynomial based 
on the constraint that the polynomial value at time equal to (Controller Time Stamp + 
Command Target Time * Controller Update Period) is the specified Command Position value. 
Since there is no dependency on the motion axis update rate, the polynomial coefficients 
computed by each device are identical. Since neither device has an update that coincides with 
this target time, they use the fine interpolation polynomial to calculate the command position 
reference for each motion axis update until a fresh command position is received from the 
motion controller. If anew command position does not arrive until well after the target time, 
the motion axis device continues to use the same polynomial equation to “extrapolate” 
command position for subsequent motion axis updates as shown in the above diagram. This 
extrapolation continues until fresh data arrives and new coefficients can be calculated. In this 
way, whether by interpolation or extrapolation, each slave axis runs smoothly and the two axes 
stay phase locked with the master axis. 


Transmission Latency Independence 


Precise coordination of multiple motion axes can be maintained even when the Controller-to- 
Device Connection packets incur significant delays while traveling across the CIP network. In 
the diagram below, the packet for Slave Drive Axis 2 has incurred a significant delay during 
transmission. As a result, the command position for this axis must be extrapolated from the last 
fine interpolation polynomial. This allows the axis to move smoothly through a transmission 
latency disturbance. When the new command data does arrive, the new command value may 
not agree with extrapolated value due to extrapolation error. This error can result in a 
disturbance to the motion profile. The magnitude of the extrapolation error depends on the 
dynamics of the motion profile and the controller update rate. In most real-world applications, 
transmission latencies lasting several update periods can occur without any noticeable 
disturbance to the associated motion profile. 


Figure 6-41.9 Coordination of Multiple Drive Axes in case of Delayed Controller-to-Drive 
Connection Packets 
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System Time Offset Compensation 


Motion control on CIP is built on the foundation of CIP Sync™ and its underlying IEEE-1588 
time synchronization protocol, which defines a mechanism to distribute and synchronize time 
for devices on a network. Unfortunately, IEEE-1588 makes no guarantee as to how soon all the 
devices in the system respond to a step change in the master’s time and has no provision for 
handling this condition. This step change in time may be caused, for example, by the user 
manually adjusting the master’s clock due to correct drift in the clock or by a change in time 
mastership. According to IEEE-1588, step changes to the master clock time must propagate 
through the distributed time system, and the time to propagate this step change in time through 
the system from the time master to the furthest time slave is a function of the sync packet 
interval (default is 2 seconds) and the number of hops (1 hop per 1588 boundary clock, e.g. a 
switch implementing the 1588 protocol). This is illustrated in the figure below. 


Figure 6-41.10 Propagation of a Step Change in Time 
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In the illustration, the Source Clock is going to receive a System Time adjustment one sync 
interval before the Destination Clock. Thus, System Time for the Source Clock is going to be 
skewed relative to System Time for the Destination Clock for an entire sync packet interval. 


The variability in propagating this time adjustment though the system creates a problem for 
time stamped based motion control in that the time stamp in the source device, say the 
controller, may not be applicable when received by the destination device, say a drive, because 
System Time for the source and destination devices is skewed. This is effect is further 
illustrated in the following table. 
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Table 6-41.37 Propagation of a Step Change in Time 


Time Sync Interval Master Time Source Time Destination Time (Drive) 
(Controller) 
1 100 100 100 
2 200 200 
3 1300 300 
4 1400 1400 
5 1500 1500 1500 


At Time Sync Intervals 1 and 2, both the timestamp source clock in the motion controller, and 
timestamp destination clock in the motion axis device both have the same notion of time, i.e. 
System Time. At Sync Interval 2, a step change in time occurs at the master clock that 
propagates to the motion controller in Sync Interval 3, thus affecting the source clock time 
stamps sent to the motion axis device. It is not until Sync Interval 4 that the motion axis device 
sees the step change. Any time stamp data sent from the controller to the motion axis device 
between Sync Intervals 3 and 4 will not correlate with its notion of time. 


CIP Motion and CIP Sync extend the 1588 protocol to handle this condition. This is done by 
defining a run-time algorithm in the timestamp destination device that can detect this time step 
condition and adjust the value of the received timestamp so that it is accurate. Two conditions 
are possible: 


1. The source device has seen a step change in time but the destination device has not. 


2. The destination device has seen a step change in time but the source device has not. 


The key component of the algorithm is the System Time Offset value defined as part of the CIP 
Time Sync Object. This offset value is added to the local clock time to generate System Time, 
that is: 


System Time = Local Clock + System Time Offset 


When the system is synchronized, at a given moment of time, the Local Clock values and the 
System Time Offset values may differ from device to device, but the System Time value should 
be the same within the accuracy of the 1588 protocol implementation. 


A step change in time is indicated by a change in the System Time Offset value of either the 
source or destination devices. The source’s System Time Offset is sent to the destination device 
as an offset along with the source’s System Time as the data time stamp. The destination device 
compares the offset received to the previously received offset to determine if a step change has 
occurred and adjusts the received timestamp value accordingly. 


The algorithm is stated as follows: 
Timestampcomp = TimestampRec + 
((Offsetaest _ Offsetdestiast)) = (Offsets, ~ Offsets:ccasty)) 


If |((Offsetacs: — Offsetucstiast) — (Offset... — Offsetsrccastyt))| <= Sync Threshold 


Offsetaest(ast) = Offsetgest 
Offsets:cdast) = Offsets: 


Where: 
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TimestampRec = received time stamp. 

Offsetdest = the current value of the System Time Offset at the destination. 
Offsetdest(last) = the previous value of the System Time Offset at the destination. 
Offsetsrc = the received value of the System Time Offset from the source. 
Offsetsrc(last) = the previous value of the System Time Offset from the source. 


Sync Threshold = a number that defines that synchronization tolerance for the device 
application. For a typical vector drive this number should be on the order of 1 microsecond. 


The following table provides an example of how System Time Offset Compensation works. 
For illustration purposes, a packet is assumed to be sent at the sync interval with no 
propagation delay. 


Table 6-41.38 Propagation of a Step Change in Time 


Time Master Timestamp Source | ‘Timestamp Source (Controller) _| Timestamp Destination (Motion Axis) 
= - 
Interval Clock Offset | Time | stamp | Clock Offset | Time | time 
x= 
1 100 


a — 200 
1000 
4 1400 1100 a 1400 | 1400 = "ai 1400 | 1400 


At Sync Interval 2 a step change of 1000 occurs in the master clock and is propagated to the 
timestamp source clock, say the controller, in Sync Interval 3. The time stamp received at the 
destination clock, the motion axis device in this example, is compensated for by 1000 
according to the above algorithm that results in an Adjusted Controller Time Stamp value that 
is consistent with the device’s Local Time even though it has not yet seen the step change. In 
Sync Interval 4, the device sees the step change but no adjustment is made to the time stamp 
because in the compensation formula above the source and destination delta offset terms cancel 
out and the Last Offset values are updated as shown in sync interval 5 and no further offset 
compensation is required. 


— 6-288 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 6: Device Profiles, Part 5 


6-41.6 


6-41.6.1 


6-41.6.2 


6-41.6.3 


CIP Motion Drive, Type: 25hex 


Drive Startup Procedure 


In this section the start-up process of a motion axis device is discussed. For the sake of clarity 
the exact messages and their formats will not be discussed. The objective is to discuss the steps 
and the exchanges that take place between the controller and the drive in order to correctly 
configure the motion axis device. 


The drive startup involves three distinct processes, which are initiated by the CIP Controller 
and responded to by each motion axis device on the network. They are: 


1. Device Connection Creation. 
2. Device Object Configuration. 


3. Time Synchronization 


These processes may occur in parallel or consecutively depending on the particular 
implementation. Device Configuration may occur via connected or unconnected explicit 
messaging. The startup process is outlined below. 


Motion I/O Connection Creation 


Motion I/O Connections are created on EtherNet/IP using either the Forward_Open or 
Large_Forward_Open services. These services should specify the maximum size of the 
Control-to-Device and Device-to-Control Connection Data Structures applied to the Motion 
Axis Object. Configuration of the produced and consumed I/O connection paths is as described 
above. 


Motion Axis Object Configuration 


Motion Axis Object configuration is accomplished using either the Set_Attribute_List service 
or the object specific Set Drive Attribute List service defined by the Motion Axis Object and 
supported by the Motion I/O Connection. 


Time Synchronization 


All motion axis devices that support time synchronization services are required to be 
synchronized with a motion controller as part of a group, commonly embodied as a Motion 
Group. All devices in this group are sent a GroupSync service that contains the Controller 
Update Period and the System Time Offset of the motion controller. The objective of this 
procedure is to guarantee that the all the devices are synchronized or, in other words, that they 
have the same notion of time. This is accomplished by guaranteeing that no step changes to the 
motion axis device’s System Time Offset value has occurred recently and the motion 
controller’s System Time Offset and motion axis device’s System Time Offset values are based 
on a System Time reference that is consistent between the controller and the motion axis 
device. 


The following diagram illustrates how the motion controller first waits until its local clock is 
synchronized to the master System Time clock and then waits a minimum delay period to make 
sure there are no step changes to the System Time Offset. By step changes we mean changes to 
the System Time Offset that are more than a predefined threshold defined by the Sync 
Threshold attribute 
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Figure 6-41.11 Group Sync of CIP Motion Drives 
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If there have been no System Time Offset steps during this period, the motion controller is 
considered to be synchronized and initiates a series of GroupSync services to each of the 
motion axis devices. Each device returns a response indicating whether it is also synchronized 
according to the same criterion described for the motion controller. If the controller and all 
motion axis devices indicate they are synchronized, then the Motion Group is considered to be 
synchronized. 


There are two device specific parameters that are used by a motion device to determine if the 
device is group synchronized. 


1. Sync Update Delay 


2. Sync Threshold 


The Sync Update Delay is the calculated by the Motion Axis Object as the minimum time to 
wait after the last System Time Offset change greater than Sync Threshold before the device is 
considered to be group synchronized. This value is on the product of the number of networks 
hops the motion axis device is away from the grandmaster clock and the time synchronization 
interval. The Sync Update Delay attribute is typically on the order of seconds. 
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The Sync Threshold is a class attribute of the Motion Axis Object whose value is used to 
determine if the device’s local clock is frequency synchronized to the master System Time 
clock. Sync Threshold depends on the IEEE-1588 implementation, but is typically on the order 
of microseconds for a hardware assisted clock implementation. Offset time changes greater 
than the Sync Threshold are considered step changes to the System Time Offset. Offset time 
changes less than the Sync Threshold are considered normal corrections to System Time to 
compensate for clock drift and network latency variation. 


Once the motion controller and all the motion axis devices in the Motion Group are group 
synchronized, the controller can then set the Synchronous Control bit in the Controller-to- 
Device Connection header of the next cyclic packet sent to the motion axis devices indicating 
that the device can schedule its next Device-to-Controller Connection update based on the 
Controller Time Stamp and Controller Update Period contained in the connection data. The 
device indicates that it is now sending scheduled connection data based on the Controller 
Update Period by setting the Synchronous Mode bit in the Device-to-Controller Connection 
header of the next cyclic packet sent to the motion controller. Data exchange between the 
controller and the motion axis device proceed thereafter according the Motion Timing Model. 


Device Visualization 


The motion axis device requires visualization components to quickly diagnose the condition of 
the device. These components range from bicolor LEDs to multi-character alphanumeric 
displays. This section defines the requirements for these visualization components and 
appropriate labels for these components when employed by the device. When applied to 
different CIP Networks, the Network Status and Module Status LED behavior shall conform to 
the LED behavior of the associated CIP network to which the device is connected. The 
mapping of the device’s Module Status LED states to the Motion Axis Object states is fully 
defined in the Motion Axis Object section on Visualization. 


Table 6-41.39 Motion Visualization Components 


Visualization Component Associated Label 
Network Status LED “Net Status” “NS” 
Module Status LED “Mod Status” “MS” 
Drive Status LED Conditional * “Axis Status” “XS” 
Seven-Segment Display N/A 
Multi-char Alphanumeric Display N/A 


* Requirement may be waived by using a Multi-character Alphanumeric Display. 


** Multi-axis drive devices need multiple Drive Status LEDs, one for each drive axis. 


Ethernet Quality of Service (QoS) 


A motion axis device targeted for operation on EtherNet/IP shall utilize the standard 
EtherNet/IP prioritization scheme to be published in Volume 2. This scheme has not yet been 
finalized but it is likely to utilize Tagged Frames, as defined by IEEE 802.1p, which has been 
formally incorporated into 802.1Q. Some motion applications may require the use of Tagged 
Frames to achieve the required level of performance. Therefore, designers must consider the 
selection of hardware and firmware drivers to support “Tagged Frames" with user-selectable 
priority in their design. 
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6-42 Enhanced Mass Flow Controller Device 
Device Type: 27hex 
6-42.1 Introduction 


A Mass Flow Controller is a device that measures and controls the mass flow rate of gas or 
liquid. It contains three principle components: a mass flow rate sensor which can be one of a 
variety of types, including thermal or pressure-based; a mass flow rate metering valve which 
can be actuated by one of a variety of actuator types, including solenoid, voice coil or piezo; 
and, a controller which closes the loop by receiving a setpoint and driving the actuator such 
that the mass flow rate is controlled to the set point. 


This Enhanced Mass Flow Controller Device Type differs from Mass Flow Controller Device 
Type 1Ahex by supporting both upstream process gas Temperature and upstream process gas 
Pressure in separate instances of the S-Analog Sensor Object. 


6-42.2 Object Model 


The Object Model in Figure 6-42.1 represents an Enhanced Mass Flow Controller Device. The 
table below indicates: 

e the object classes present in this device 

e whether or not the class is required 

e the number of instances present in each class 


Table 6-42.1 Objects Present in an Enhanced Mass Flow Controller Device 


Object Class Optional/Required # of Instances 
Identity Required al 
Message Router Required 1 
DeviceNet Required 1 
Connection Required at least 
1 1/O and 
1 Explicit 
Assembly Required at least 
1 Input and 
1 Output * 
S-Device Supervisor Required 1 
S-Gas Calibration Required 1 or more 
S-Analog Sensor Required 3 
Instance 1 — flow 
Instance 2 — pressure 
Instance 3 - temperature 
S-Analog Actuator Conditional i 
S-Single Stage Controller Conditional * uk 


1 Required for a Mass Flow Controller, a device that contains a Valve and a Controller. Not 
supported in a Mass Flow Meter Device (an MFC without a Valve or a Controller). 
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Class Subclasses 


Each class level subclass defines a unique meaning for an overlapping range of class attribute 
IDs and/or class service IDs. The range for the subclass definitions begins at ID 96 and 
numbers downward for attributes, and ID 63), and numbers downward for services. The 
subclass for a given class is identified by the value of its Subclass class attribute. There are no 
class level subclasses specified for this device. 


Instance Subclasses 


Each instance level subclass defines a unique meaning for an overlapping range of instance 
attribute IDs and/or instance service IDs. The range for subclass definitions begins at ID 96 and 
numbers downward for attributes, and ID 63), and numbers downward for services. The 
subclass for a given instance is identified by the value of its Subclass instance attributes. The 
following tables identify which instance IDs are assigned subclasses for this device. 


Table 6-42.2 S-Analog Sensor Object Subclasses 


Instance Subclass Name Subclass ID Required Function Restrictions 
ID (Attribute 99 
Value) 


ad Flow Diagnostics Required | Added None 
diagnostics for 
EMFC 


Table 6-42.3 S-Gas Calibration Object Subclass 


Instance Subclass Name Subclass ID Required Function Restrictions 
ID (Attribute 99 
Value) 


il Standard T & P Optional Standard None 
Temperature and 
Pressure 
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Figure 6-42.1 Object Model for the EMFC device 
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How Objects Affect Behavior 


Table 6-42.4 Object Effect on Behavior 


Object Effect on behavior 
Identity Supports the Reset service. Upon receipt of a Reset Service Request of any Type, the 
Identity Object sends a Reset Service Request to the S-Device Supervisor. 
Message Router No effect 
DeviceNet Configures port attributes (node address, data rate, and BOI) 
Connection Class Contains the number of logical ports into or out of the device 
Assembly Defines input/output and configuration data format 
S-Device Supervisor Supports the Stop, Start, Reset, Abort, Recover and Perform_Diagnostic services for 


ALL Application Objects in the device and consolidates the Exception Conditions 
and Application Objects’ Status. 


This object behaves differently from the Identity Object in that the S-Device 
Supervisor object provides a single point of access to the Application Objects only; it 
does not affect the DeviceNet specific objects (i.e., Identity, DeviceNet, Connection, 
etc.). 


S-Gas Calibration Modifies the correction algorithm of the S-Analog Sensor object which includes the 
selection mechanism to enable an S-Gas Calibration object instance. 


S-Analog Sensor Feeds the process variable to the Single Stage Controller object 
S-Single Stage Controller __| Feeds the control variable to the Analog Actuator object 
S-Analog Actuator Operates the Flow Control Valve of the device 


— 6-294 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 6: Device Profiles, Part 5 
Enhanced Mass Flow Controller, Type: 27hex 


6-42.6 Defining Object Interfaces 


Table 6-42.5 Object Interfaces 


Object Interface 
Identity Message Router 
Message Router Explicit Messaging Connection Instance 
DeviceNet Message Router 
Connection Class Message Router 
Assembly I/O Connection or Message Router 
S-Device Supervisor Assembly or Message Router 
S-Gas Calibration Message Router 
S-Analog Sensor Assembly or Message Router 


S-Single Stage Controller | Assembly or Message Router 
S-Analog Actuator Assembly or Message Router 


6-42.7 I/O Assembly Instances 


The following table identifies the I/O assembly instances supported by the EMFC and EMFM 
devices. 


Table 6-42.6 I/O Assembly Instances 


Required 
Number | EMFC EMFM Type Name 
1 


Zz 


Input Flow 
Y (default) | Y (default) | Input Status and Flow 

Input Status, Flow and Valve 

Input Status, Flow, and Setpoint 

Input Status, Flow, Setpoint and Valve 

Input Status, Flow, Setpoint, Override and Valve 
Y (default) Output | Setpoint 


Output | Override and Setpoint 


OL amIPn{iI my ay] RR] Ww] nm 


Input Status 


(assembly not used) 


(assembly not used) 
(assembly not used) 

Input FP-Flow 

Input FP-Status and Flow 

Input FP-Status, Flow and Valve 


= 
o>) 


= 
N 


Input FP-Status, Flow, and Setpoint 


ra 
N 


Input FP-Status, Flow, Setpoint and Valve 
Input FP-Status, Flow, Setpoint, Override and Valve 


= 
i<o) 


Output | FP-Setpoint 


N 
Oo 


Output | FP-Override and Setpoint 


N 
rm 


Input Status, Flow, Pressure and Temperature 


N 
N 


Input Status, Flow, Valve, Pressure and Temperature 
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Required 


Name 
FP — Status, Flow, Pressure and Temperature 
FP — Status, Flow, Valve, Pressure and Temperature 


Exception Detail Alarm and Exception Detail Warning 


Note that FP refers to “Floating Point”, which is analogous to the data type “REAL”. 


I/O Assembly Object Instance Data Attribute Format 


The manufacturer of an Enhanced Mass Flow Controller Device must specify which Assembly 
instances are supported by the device. 


The I/O Assembly Data attribute has the format shown below. 


Table 6-42.7 I/O Assembly Data Attribute 


Po | 


1 Flow (low byte) 
Flow (high byte) 
2 | oo | Status 
Flow (low byte) 
Flow (high byte) 
3 | 0 | Status 
Flow (low byte) 
Flow (high byte) 
Valve (low byte) 
Valve (high byte) 
4 | 0 | Status 
Flow (low byte) 
Flow (high byte) 
Setpoint (low byte) 
Setpoint (high byte) 
D | Status 
Flow (low byte) 
Flow (high byte) 
Setpoint (low byte) 
Setpoint (high byte) 
Valve (low byte) 
| 6 | Valve (high byte) 
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6 


Status 
Flow (low byte) 
Flow (high byte) 
Setpoint (low byte) 
Setpoint (high byte) 
Override 
Valve (low byte) 
Valve (high byte) 
Setpoint (low byte) 
Setpoint (high byte) 
Override 
Setpoint (low byte) 
Setpoint (high byte) 
Status 
Flow (low byte) 
Flow 
Flow 
Flow (high byte) 
Status 
Flow (low byte) 
Flow 
Flow 
Flow (high byte) 
Status 
Flow (low byte) 
Flow 
Flow 
Flow (high byte) 
Valve (low byte) 
Valve 
Valve 
Valve (high byte) 
Status 
Flow (low byte) 
Flow 
Flow 
Flow (high byte) 
Setpoint (low byte) 
Setpoint 
Setpoint 
Setpoint (high byte) 
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[ae 


Status 
Flow (low byte) 
Flow 
Flow 
Flow (high byte) 
Setpoint (low byte) 
Setpoint 
Setpoint 
Setpoint (high byte) 
Valve (low byte) 
Valve 
Valve 
Valve (high byte) 
Status 
Flow (low byte) 
Flow 
Flow 
Flow (high byte) 
Setpoint (low byte) 
Setpoint 
Setpoint 
Setpoint (high byte) 
Override 
Valve (low byte) 
Valve 
Valve 
Valve (high byte) 
Setpoint (low byte) 
Setpoint 
Setpoint 
Setpoint (high byte) 
Override 
Setpoint (low byte) 
Setpoint 
Setpoint 
Setpoint (high byte) 
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21 Em status 
Flow (low byte) 
Flow (high byte) 
Pressure (low byte) 

4 Pressure (high byte) 
Temperature (low byte) 
| 6 | Temperature (high byte) 

22 | 0 | Status 
Flow (low byte) 
Flow (high byte) 
Valve (low byte) 

4 Valve (high byte) 
Pressure (low byte) 

6 Pressure (high byte) 
Temperature (low byte) 

8 Temperature (high byte) 

23 0 Status 

1 Flow (low byte) 

2 Flow 

3 Flow 

4 Flow (high byte) 

5 Pressure (low byte) 

6 Pressure 

7 Pressure 

8 Pressure (high byte) 

9 Temperature (low byte) 

10 Temperature 

11 Temperature 

12 Temperature (high byte) 
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24 0 Status 
i Flow (low byte) 
2 Flow 
3 Flow 
4 Flow (high byte) 
5 Valve (low byte) 
6 Valve 
Z Valve 
8 Valve (high byte) 
9 Pressure (low byte) 
10 Pressure 
a Pressure 
12 Pressure (high value) 
13 Temperature (low byte) 
14 Temperature 
15 Temperature 
Temperature (high byte) 
25 Status 


Exception Detail Alarm 0 (size, common) 
Exception Detail Alarm 1 (common 0) 
Exception Detail Alarm 2 (common 1) 
Exception Detail Alarm 3 (size, device) 

Exception Detail Alarm 4 (device 0) 
Exception detail Alarm 5 (device 1) 
Exception Detail Alarm 6 (size, manufacturer) 
Exception Detail Alarm 7 (manufacturer, 0) 
Exception Detail Warning 0 (size, common) 

Exception Detail Warning 1 (common 0) 

Exception Detail Warning 2 (common 1) 

Exception Detail Warning 3 (size, device) 
Exception Detail Warning 4 (device 0) 
Exception Detail Warning 5 (device 1) 


Exception Detail Warning 6 (size, manufacturer) 


ee eee ee ee ee PR 


Exception Detail Warning 7 (manufacturer, 0) 


Mapping I/O Assembly Data Attribute Components 


Each of the S-Analog Sensor, S-Analog Actuator and S-Single Stage Controller object 
definitions specifies a behavior that modifies the Data Type of certain attributes based upon the 
first valid I/O connection established to an Assembly Object instance. In order to maintain 
consistency, this device type will only allow connections to either INT or REAL based 
Assembly instances. Once a valid connection is established, attempts to configure connections 
to a different type of Assembly instance will return an error 
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The following table indicates the I/O assembly Data attribute mapping for this EMFC device. 


Table 6-42.8 I/O Assembly Data Mapping 


Data Component Instance Attribute 
Name Number 


Setpoint S-Single Stage Ohi 1 Setpoint INT 
Controller 

FP-Setpoint S-Single Stage 33hex al Setpoint REAL 
Controller 


pe Detail S-Device Supervisor 30h Exception Detail STRUCT 
Alar Alarm 

Exception Detail S-Device Supervisor | 30nex Exception Detail STRUCT 
Warning Warning 


Pressure S-Analog Sensor Indicated Pressure | 6 | INT 
FP—Pressure S-Analog Sensor Indicated Pressure | 6 | REAL 


Temperature S-Analog Sensor Olay fs) Indicated INT 
Temperature 

FP-Temperature S-Analog Sensor Shies 3 Indicated REAL 
Temperature 


Object Limitations and Specific Definitions 


This section describes limitations and specific definitions applicable to the listed objects of this 


device profile when these objects are applied in this type of device. 


S-Device Supervisor Object Instance 
The following limitations apply: 


Table 6-42.9 Device Type Attribute Limitations 


Attribute Limitation 


Device Type Supported Values: 
“EMFC” = Enhanced Mass Flow Controller device 


“EMFM” = Enhanced Mass Flow Meter device 


Specific Definitions 


The following table specifies the data attribute bit mapping for the Device Exception Detail 
bytes for this EMFC device. For more descriptive information, see the definition of the S- 

Device Supervisor Object Class. Noted, for each entry, is the Object from which the Status 
byte/bit is mapped. See the object specification for the detailed bit mapping. 
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Any Exception Bit not supported must default to 0. Note that this profile allows for only one 
byte of manufacturer specific exception detail. 


Note that the status bits for the Pressure (Instance 2 of the S-Analog Sensor object) and the 
Temperature (Instance 3 of the S-Analog Sensor object) shall use the same bit mapping as the 
Flow instance (Instance 1 of the S-Analog Sensor object). 


Table 6-42.10 Device Exception Detail Mapping 


Data Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
Component 
MFC Device 


Exception Detail 
Size 

MFC Device 
Exception Detail 
Byte 0 


Control 


S-Single 
Stage 
Controller 


S-Analog 
Sensor 


MEFC Device 
Exception Detail 


Byte 1 


Pressure 
Low 


Pressure 
High 
S-Analog | S-Analog 
Sensor Sensor 
Instance 2 | Instance 2 


Gas Temp 
High 
S-Analog 
Sensor 
Instance 3 


Gas Temp 
Low 


S-Analog 
Sensor 
Instance 3 


S-Analog Low Reading 
Reserved | Reserved | Not Reading } Not 
0 0 
pressure 


Sensor Valid * 
Valid Reading 


S-Analog 
Sensor 
S-Analog Valid 
Sensor S-Analog 
1 Only used in | Warning Exception "| this bit is always = 0 in the ae Exception _ Refer to the S- 


Reserved | Reserved | Valve High | Valve Flow Flow High | Flow Not 
S-Analog | Low 
Actuator S-Analog 
Actuator 
Flow 
temperature | Sensor 
Analog Sensor instance. 


Manufacturer 
Exception Detail 
Size 


Manufacturer 
Exception Detail 


S-Analog Sensor Object 
The following limitations apply: 


Table 6-42.11 S-Analog Sensor Object Attribute Limitations for Instance 1, (flow) 


Attribute Limitation Requirement Default 
Data Type Supported Values = {INT; REAL} Supported Values = {INT; REAL} INT 
Data Units Supported Values = {Counts & Units of Supported Values = {Counts; sccm} Counts 

the Flow Group} (see Appendix D) 
Offset-A. Supported Values = {INT; REAL} Supported Values = {INT; REAL} INT 
Data Type 
Gain Data Supported Values = {INT; REAL} Supported Values = {INT; REAL} INT 
Type 
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6-42.9.5 
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S-Analog Sensor Object 
The following limitations apply: 


Table 6-42.12 S-Analog Sensor Object Attribute Limitations for Instance 2, (pressure) 


Data Type Supported Values = {INT; REAL} Supported Values = {INT; REAL} INT 


Data Units Supported Values = {Counts & Units of Supported Values = {Counts; psi} Counts 
the Pressure Group} (see Appendix D) 


Offset-A Supported Values = {INT; REAL} Supported Values = {INT; REAL} INT 
Data Type 


Gain Data Supported Values = {INT; REAL} Supported Values = {INT; REAL} INT 
Type 


S-Analog Actuator Object 
The following limitations apply: 


Table 6-42.13 S-Analog Actuator Object Attribute Limitations 


Data Type Supported Values = {INT; REAL} Supported Values = {INT; REAL} INT 


Data Units Supported Values = {Counts, %, Supported Values = {Counts; %} Counts 
Voltage, Current & Units of the Flow 
Group} (see Appendix D) 


Gain Data Supported Values = {INT; REAL} Supported Values = {INT; REAL} INT 
Type 


S-Single Stage Controller Object 
The following limitations apply: 


Table 6-42.14 S-Single Stage Controller Object Attribute Limitations 


Data Type Supported Values = {INT; REAL} Supported Values = {INT; REAL} INT 


Data Units Supported Values = {Counts, %, Supported Values = {Counts; %} Counts 
Voltage, Current & Units of the Flow 
Group} (see Appendix D) 


Process Not accessible over the network. The N.A. N.A. 

Variable Process Variable input to this object 
instance is the value of the S-Analog 
Sensor object instance Value attribute. 


CV Data Not supported N.A. N.A. 
Type 


Control Not accessible over the network. The N.A. N.A. 
Variable Control Variable output from this object 
is the value of the S-Analog Actuator 


object instance Value Attribute. 


Note - % refers to a vendor specific value that equates to 0 to 100% of full scale 
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6-42.10 Defining Device Configuration 


Public access to the S-Device Supervisor, S-Analog Sensor, S-Analog Actuator, S-Single Stage 
Controller, and S-Gas Calibration Objects by the Message Router must be supported for 
configuration of this device type. 
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7-1 Introduction 


This chapter describes: 


e standardized methods for device configuration 
e the structure of an Electronic Data Sheet (EDS) 


The information provides reference material for: 
e product developers 
e configuration tool designers 
7-1.1 Terms and Definitions Used in this Chapter 


Table 7-1.1 Terms and Definitions 


Term Meaning 
decoded format The decoded attribute data values in CIP message format 
EDS The abbreviation for Electronic Data Sheet, a file on disk that contains 
configuration data for specific device types 
encoded The encoded attribute data values in the Electronic Data Sheet Format 
CIP path The address of an object attribute in CIP Class-Instance-Attribute format 
full parameter object A parameter object instance within a device that contains the data value, prompt 


strings, data conversion factors, and other information associated with the parameter 


stub parameter object A shorthand form of a parameter object instance that stores only fields 1-6 


Rack Typically a multi-slot chassis that contains a variety of modules 
Adapter A device connected directly to a CIP network, which can be placed in one or more 
slots of a rack 
Module A device that can be placed in one or more slots of a rack 
Adapter Rack A connection to an adapter whose O->T and T->O application data includes data 
Connection produced/consumed by one or more modules 
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7-2 


7-2.1 


7-2.1.1 


Configuration Options 


The CIP standard allows for remote device configuration across the network and for embedding 
configuration parameters in devices. Using these features, you can select and modify device 
configuration settings for use in a particular application. The CIP interface allows access to a 
device’s configuration settings. 


Figure 7-2.1 Illustration of Remote Device Configuration 
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Devices containing configuration settings accessible only through the CIP communications 
interface require a configuration tool to change these settings. Devices configured only through 
the use of external switches, jumper blocks, thumbwheels, or other proprietary interfaces do not 
require a configuration client (tool) to modify the device’s configuration settings. However, the 
device designer must provide a means for a tool to access and determine the state of hardware 
configuration switches. 


Configuration Data Sources and Methods 


This section describes possible methods for storing and accessing a device’s configuration data 


e A printed data sheet 

e An Electronic Data Sheet (EDS) 

e Parameter Objects and Parameter Object Stubs 

e A combination of an EDS and Parameter Object Stubs 

e A Configuration Assembly and any of the above methods 

e A Device Type Manager (DTM) loaded into a Field Device Tool software package 


Configuration Support Using Printed Data Sheets 


When using configuration information collected on a printed data sheet, configuration tools can 
only provide prompts for service, class, instance, and attribute data and relay this data to a 
device. A configuration tool of this type does not determine the context, content, or format of 
the data. The figure below shows the relationship between configuration information and the 
tool. 


A 
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7-2.1.2 


Figure 7-2.2 Illustration of Printed Data Sheet Support 
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Configuration Support Using an Electronic Data Sheet 


You can provide configuration support for your device by using a specially formatted ASCII 
file, referred to as the Electronic Data Sheet (EDS). An EDS provides information about the 
device configuration data’s: 


e context 
e content 
e format 


The information in an EDS allows configuration tools to provide informative screens that guide 
a user through the steps necessary to configure a device. Section 7-3 describes electronic data 
sheets. 


An EDS provides all of the information necessary to access and alter the configurable 
parameters of a device. This information matches the information provided by instances of the 
Parameter Object Class. The CIP Object Library describes the Parameter Object Class in 
detail. 


Manufacturers who choose not to supply an EDS on computer-readable media can provide a 
printed listing of their EDS so that the end user may create the computer-readable EDS using a 
text editor. 


The following figure shows device configuration by a configuration tool that supports an EDS. 
The application objects in the device represent the destination addresses for configuration data. 
These addresses are encoded in the EDS. 
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Figure 7-2.3 Illustration of Using Electronic Data Sheets for Configuration 
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7-2.1.3 Configuration Support Using Parameter Objects and Parameter Object Stubs 


The device’s public Parameter Object, which is an optional data structure in a device, provides 
a third method for accessing the configuration data of a device. When a device uses parameter 
objects, it requires one instance of the Parameter Object class for each supported configuration 
parameter. Each instance is linked to a configurable parameter that can be an attribute of one of 
the device’s other objects. Changing the Parameter Value attribute of a Parameter Object 
causes a corresponding change in the attribute value, as indicated by the Link Path attribute. 


A Full Parameter Object contains all of the information necessary for device configuration. 
The CIP Object Library, contains a complete definition of the Parameter Object. A partially 
defined Parameter Object, called a Parameter Object Stub, contains the portion of 
configuration information needed to perform configuration that excludes user prompts, limit 
testing, and descriptive text that guides a user through the configuration. 


7-2.1.3.1 Using Full Parameter Objects 


Parameter Objects embed all of the needed configuration information within the device. 
Parameter Objects provide: 


e aknown public interface to a device’s configuration data values 
e descriptive text 
e data limits, default, minimum, and maximum values 


Important: When a device contains full Parameter Objects, a configuration tool may derive all 
of the needed configuration information directly from the device. 


The following figure shows the configuration of a device by a configuration tool that supports 
full Parameter Objects. 
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Figure 7-2.4 Illustration of Using Parameter Objects To Configure a Device 
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7-2.1.3.2 Using Parameter Object Stubs 


Parameter Object stubs provide an established address to a device’s configuration data values 
without requiring specification of descriptive text, data limits, and other parameter properties. 
When a device contains Parameter Object stubs, a configuration tool may obtain additional 
configuration information from an EDS or provide only a minimal interface to a parameter for 
modification. 


7-2.1.4 Configuration Using an EDS and Parameter Object Stubs 


A configuration tool may obtain information from partial Parameter Objects or Parameter 
Object stubs embedded in a device that provides a companion EDS. The EDS supplies 
additional parameter information needed by a configuration tool. The Parameter Object stubs 
can provide a known public interface to a device’s parameter data values, while the EDS 
supplies descriptive text, data limits, and other parameter properties such as the: 


e Data type and size for data validation 
e Default data selections 

e Descriptive user prompts 

e Descriptive help text 

e Descriptive parameter names 


The figure below shows the configuration of a device by a configuration tool that supports 
Parameter Object stubs with electronic data sheets. 
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Figure 7-2.5 Illustration of EDS and Parameter Object Stubs to Configure a Device 
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7-2.1.5 Configuration Using a Configuration Assembly 


An instance of the Configuration Assembly allows bulk upload and download of configuration 
data. If you use this method for device configuration, you shall document: 

e The format of the configuration data blocks 

e The address mapping for each configurable attribute 

When specifying the data attribute of the Configuration Assembly, you shall: 


e List the data components in the order given by the attribute block 

e List data components larger than one byte starting with the low order byte 

e List data components smaller than one byte justified to the right within a byte, starting with 
bit 0 

Show the format of the data blocks in a table like the following: 


Table 7-2.1 Example of Configuration Assembly Data Attribute 


Byte 


n Input Range 


In addition to specifying the device’s Configuration Assembly’s data format, you shall map the 
individual configuration data components to their associated objects. Do this by specifying the 
Class, Instance, and Attribute IDs for each data component. This is essentially the same as 
specifying the Member_List attribute of the Assembly Object. 
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7-2.1.6 


7-2.1.6.1 


The table below shows an example mapping of Configuration Assembly data attribute 
components: 


Table 7-2.2 Example of Configuration Assembly Data Attribute Components 
Data 


Component Instance Attribute Data 


Analog Output Output Range UINT 
oO 


Oo 


fC) 
Input Range Analog Input Input Range BYTE 


Configuration Using a Device Type Manager (DTM) 


Output Range 


A device can be configured by use of a Device Type Manager (DTM) software component. 
The DTM is loaded into a configuration software package that supports the Field Device Tool 
(FDT) interfaces to the DTM. This is demonstrated in below. 


Figure 7-2.6 Configuration Using a DTM Software Component 
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Like an EDS file, the DTM contains all of the device specific information for configuring the 
device. However, while the EDS file is a structured text file describing the data objects, the 
DTM is a software component that adheres to the FDT interfaces. This allows a greater level of 
flexibility to add device specific functionality into the configuration interface then can be 
achieved in an EDS file. 


Developing a Device Type Manager (DTM) 


The controlling specifications for the development of a DTM are in the FDT specification and 
the supporting annex for CIP networks. See www.fdtgroup.org for details. 
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7-3 Electronic Data Sheet Definition 


This section contains the formal specification of the electronic data sheet (EDS). The EDS 
allows a configuration tool to automate the device configuration process. The EDS 
specification provides an open standard for device configuration and compatibility among all 
CIP products. 


7-3.1 The Electronic Data Sheet 


An EDS may contain vendor-specific information in addition to the required device parameter 
information defined by this specification. The figure below shows a general block diagram of a 
sample EDS. 


Figure 7-3.1 General Block Diagram of an EDS File 
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7-3.2 The Product Data Sheet Model 


Electronic Data Sheets follow a product data sheet metaphor, modified to accommodate CIP 
requirements. Typically, a product data sheet provides a user with information needed to 
determine the product’s features and the range of user-assigned values that may be selected for 
these features. 


Figure 7-3.2 Example of a Product Data Sheet 


Product Name: Smart Widget I1 Series Z99 Dual Mode <= Name of the product 

Vendor: Always Profitable Widget Works, Inc. <= Who made it 

Model: Z99 DM <= Catalog number 
Revision: 2.1 <= Revision level 


Serial Number: 00123456789A <= Unique serial number 


The data sheet conveys information from the product manufacturer to the product user. The 
product user interprets the manufacturer’s data sheet, decides which settings must be set to 

non-default values, and performs the necessary actions to get the information from the data 
sheet into the device. 


A configuration tool that uses an EDS and parameter object stubs follows this same sequence, 
using an electronic form of the data sheet. 


To perform the actual configuration, a configuration tool uses CIP messaging to perform the 
changes in the device. Currently, the textual information in an EDS must be 
ASCII-representable characters. Future revisions of this specification will support non-ASCII 
character representations such as UNICODE. 


The EDS serves two main purposes by providing information needed to: 


e Describe each device parameter, including its legal and default values 
e Provide the user with a selection of choices for each configurable parameter in a device 
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The figure below compares the interpretation of a printed data sheet by a human with the 
interpretation of an EDS by a configuration tool. At the minimum, a CIP configuration tool 
must: 


e Load the EDS into the configuration tool’s memory 

e Interpret the EDS contents to determine the characteristics of each parameter 

e Present to the user a list of choices or data entry fields for each device parameter 
e Load the user’s parameter choices to the correct parameter addresses in the device 


Figure 7-3.3 Illustration of Using Printed Data Sheets vs EDS 
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Product developers may add optional EDS-related functions to a configuration tool. The 
specified EDS requirements provide a consistent and compatible approach for performing 
configuration in the CIP environment. This specification enforces only the requirements critical 
to achieving: 


e Consistency among vendors for the benefit of device makers 
e Compatibility among vendors for the benefit of tool makers 
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All EDS developers shall implement EDSs compliant with these requirements. Product 
developers determine all other implementation details. Every EDS interpreter designed for CIP 
products shall be capable of: 


e Reading and interpreting any standard EDS 
e Presenting information and choices to device users 
e Building the messages necessary to configure the associated CIP product 


The specification, in CIP Communication Model and Protocol, imposes strict requirements and 
protocols for transmitting messages over the CIP network. The figure below shows the 
compliancy required for each configuration process. The remainder of this chapter describes 
the requirements which shall be satisfied for all configuration tools that use an EDS. These 
requirements describe: 


e EDS encoding 
e EDS command language 
e EDS syntax 


Figure 7-3.4 Compliancy Requirements for the Configuration Process 
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7-3.3 Using an EDS with Configuration Tools 


CIP configuration tools: 


e Extract user prompt information from a standard EDS 
e Present this information to the user in a human-readable form 


The tool developer determines the: 


e user interface format 
e operator interaction 


7-3.3.1 EDS Interpreter Functions 


The interpreter shall: 


e Collect parameter selections required by an EDS 
e Build the CIP messages necessary to configure a device 
e Contain the object addresses for each device parameter requiring configuration 


7-3.3.2 EDS File Organization 


This section contains the file encoding requirements for EDSs. The EDS encoding 
requirements define the standard file encoding format to use for CIP products without regard to 
the configuration tool host platform or file system. 


The term “file” as used in this chapter refers to any recognized file format associated with a 
configuration tool’s file system without regard to the file storage media. An EDS contains an 
ASCII representation of a device’s Parameter Objects and some additional information required 
to support object addressing. 
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7-3.3.2.1 EDS Content 


A single file must contain the entire EDS. The following table summarizes the structure of the 
sections, legal section delimiters, and the order of sections in an EDS. 


Table 7-3.1 Sections of an EDS File 


Section Name Legal Delimiter 
File] 


Device Description [Device] 


Placement Required/Optional 


em 


File Description Required 


Required 


I/O Characteristics [1O_Info] See Note 1 DeviceNet specific. See Vol 3, 
DeviceNet Adaptation of CI 
for details 


Enumerated Parameters [EnumPar] See Note 1 DeviceNet specific. See Vol 3, 
DeviceNet Adaptation of CIP 
for details 


Parameter Class [ParamClass] See Note 1 Optional 

Parameters [Params] Optional 

Parameter Groups [Groups] Optional 

Assembly [Assembly] Optional 

Device Classification [Device Classification] Optional 

Connection Characteristics [Connection Manager] Optional 

Port Port] See Note 1 Optional 

Modular [Modular] See Note 1 Optional 

Variant_IO_Info [Variant_IO_Info] See Note 1 DeviceNet specific. See Vol 3, 
DeviceNet Adaptation of CIP 
for details 

Capacity [Capacity] See Note 1 Optional 


Connection Configuration Class | [Connection Configuration] | See Note 1 Conditional (See Note 2) 


See 


Z 


Event Enumeration 


em 


EventEnum] ote 1 Optional 


Symbolic Translation [SymbolicTranslation] See Note 1 Optional 


Object class sections See Chapter 7-3.6.1.1 


Internationalization [Internationalization] See Note 1 Optional 


Note 1 - Placement of optional groups only needs to follow the required groups. 


Note 2 — Required if the device supports the Connection Configuration object, not allowed if the device does not 
support the Connection Configuration object. 


Observe these rules when defining an EDS: 


e EDS White Space - The EDS interpreter shall treat certain characters as white space 
characters. These characters, read by the interpreter but not encoded as human-readable 
characters, designate the presence of blank space in a file. White space characters are: 

e New line 

e =©Carriage Return 

e =Linefeed 

e Tabs, vertical and horizontal 

e Form Feed 

e End of File marker 
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e Comments 

e Keyword characters — All keywords within an EDS file must be composed of ASCII 
characters from the following list: 

e Upper case letters A through Z 

e Lower case letters a through z 

e Numerals 0 through 9 

e The special character underscore "_ 

e The space character (The space may only be used in a section keyword. The space may 
only appear internal to a section name, and multiple sequential spaces are invalid) 

e Sections - The EDS file must be partitioned into required and optional sections. 

e Section delimiters - Each section in the EDS must be properly delimited by a section 
keyword. 

e Section Keywords — Each section keyword is defined to be the text between the beginning 
of section keyword delimiter "[" and the terminating delimiter "]". The characters valid for 
use in section keywords are shown above. Section keywords shall not be case sensitive. 
There are two types of section keywords, public and vendor specific. 

e Section order - Each required section must be placed in the required order. 

e Entry - Each section in the EDS contains one or more entries beginning with an entry 
keyword followed by an equal sign. The entry keyword meaning depends on the context of 
the section. A semicolon indicates the end of the entry, and entries may span multiple lines. 

e Entry Keywords — An entry keyword consists of a unique sequence of keyword characters. 
Entry keywords shall not be case sensitive. There are two types of entry keywords, public 
and vendor specific. 

e Public Keyword — A Public Keyword shall always be defined by ODVA and shall be listed 
within Chapter 7 of Volume 1, Common Industrial Protocol Specification. A public 
keyword shall never begin with any numeric digit. 

e Entry fields - Each entry contains one or more fields. A comma delimiter separates each 
field. 

e A white space or nothing between commas (for example: keyword = x,,x;). 

e A white space or nothing between a comma and a semi-colon (for example: keyword = 
X,}). 

e A white space or nothing between an equal and comma (for example: keyword = ,x;). 

e A white space or nothing between an equal and semi-colon (for example: keyword = ;). 

Trailing optional fields can be omitted by ending the Entry with a semicolon. The meaning 

of the field(s) depends on the context of the section. 

e Complex data fields — Certain entry fields must be specified with data that cannot be 
specified by a single value between the comma delimiters. The ability to further delimit an 
entry field is defined via the use of one or more sets of matching brace characters "{" and 
"}". The content between brace characters is considered a single item or entry. Content 
may be grouped in multiple braces. 


mow 
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e Vendor-Specific Keywords - Section and Entry Keywords may be vendor-specific. Vendor 
Specific Section Keywords shall begin with the Vendor ID of the company making the 
addition followed by an underscore (VendorID_VendorSpecificKeyword). Vendor Specific 
Entry Keywords not in a vendor-specific section shall begin with the Vendor ID of the 
company making the addition followed by an underscore 
(VendorID_VendorSpecificKeyword). Vendor Specific Entry Keywords in a vendor- 
specific section are always vendor-specific; they are not required to begin with the Vendor 
ID of the company making the addition. The VendorID shall be displayed in decimal and 
shall not contain leading zeroes. Each vendor is responsible for maintaining and 
documenting their vendor-specific keywords. 


The following examples highlight the structure of the electronic data sheet (Note: The “$” 
character denotes a comment.) 


Figure 7-3.5 Basic Structure of an EDS file 


[section name] 
$ Comment - extends to end of line 


Entryi=Field1, Field2, Field3; $ Entire entry on one line 


Entry2=Fieldi, Field2, Field3, Field4; $ Entire entry on one line 


Entry3= $ Multiple line entry 
Field1, $ Field1 
Field2, $ Field2 
Field3; $ Field3 
Entry4= $ Combination 
Field1, Field2, $ Fields 1 and 2 on one line 
Field3, $ Field3 
Field4; $ Field4 


65535 _Entry= $ Vendor Specific entry for Vendor_ID 65535 


Field1, Field2; $ with two fields 
Entry5 = 1, $ Field 1 specifies the value 1 
{1,2,3}; $ Field 2 specifies an array or 


$ structure with three values 


Entry6 = { 44, {22,33,11} }; $ Entry 6 specifies a single field. 
$ The field contains two sets of data. 
$ The first set is a single value 44. 
$ The second set contains three values. 


Note from the examples that an entry can extend over multiple lines as long as commas 
properly delimit the fields. The configuration tool ignores any whitespace characters, including 
comments, tabs, and spaces. Comments start at the comment delimiter ($) and extend to the end 
of the line. All entries must terminate with a semicolon. 


7-3.4 File Naming Requirements 


Currently no file naming conventions exist for disk-based EDS files, except for files in a 
DOS/Windows environment. The file should have the suffix “.EDS” appended to the file name. 
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7-3.5 EDS Data Encoding Requirements 


This section describes the data encoding requirements for the EDS file. 


7-3.5.1 ASCII Character File Convention 


All data in the EDS must be encoded using 8-bit ASCII characters, where all references to 
“ASCII characters” mean an 8-bit ASCII character format (as defined by Tables 1 and 2, Row 
00 of the IEC/ISO 10646-1). Characters that cannot be displayed on an ANSI terminal cannot 
be used in identifier names or in data representations. 


7-3.5.2 Character String Convention - (STRING) 


All references to STRING in this chapter mean ASCII character strings of fixed length without 
null terminators. Double quotes enclose all strings. 


Characters between double quotation marks (“) are interpreted as string data. There are two 
forms of string data conversions. Characters contained between double quotation marks are 
converted into 8-bit characters. Characters contained between double quotation marks that are 
preceded by a capital L are converted into UNICODE (16-bit) characters. The following are 
examples: 


e “This results in a string composed by 8-bit characters”. 
e L”A string of UNICODE characters, including the Greek character Pi \u03C0” 


Note: the text \u03C0 specifies a single 16-bit character whose value is 03C0. In the 
UNICODE character set, this is Table 9, Row 3, Basic Greek — the character for lower case 
"Pi". Descriptions of character escape sequences are described in subsequent section 7-3.5.4. 
Handling Insufficient Characters in a String Field 
An EDS interpreter uses right-justification of characters in a field and fills any unspecified 
characters with leading blanks (ASCII 0x20) for the remaining length of the string. For 
example, if a parameter has a maximum string length of 8 and receives the string 

”123AB”, 
the interpreter decodes the string as: 

?am~ 1 23AB”, 
where the tilde characters (~) represent spaces. 
Handling Excess Characters in a String Field 
If a given string field contains too many characters, the EDS interpreter truncates characters 
from left to right. For example, if a parameter has a maximum string length of 8 and receives 
the string 


”*T23ABCDEFG”, 


the EDS interpreter truncates the string to 
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7-3.5.3 String Concatenation 


Multiple strings with no intervening commas are concatenated. For example, the line 
"ABG”” 7123" 2XYZ” 
is interpreted as: 
”ABC123XYZ” 
The strings may also be on separate lines. For example, the following lines 
” ABC” $ this is a comment 
gi Wg 
OY Zi 
are also interpreted as: 
”ABC123XYZ” 


For a UNICODE string (long string), only the first double quotation mark shall be preceded by 
a capital L. Example: L” ABC” ”123” ”X YZ” is the same as L”ABC123XYZ”. 


7-3.5.4 String Escape Sequences 


The EDS interpreter shall recognize all listed sequences. Interpretation is application specific. 
The escape sequences are: 


\\ translates to a \ 

\n translates to a newline 

\t translates to a tab 

\v translates to a vertical tab 

\b translates to a backspace 

\r translates to a carriage return 

\f translates to a form feed 

\a translates to the BELL character (0x07) 
\? translates to a ? 


\0 translates to a null 
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\” translates to a” 
\ translates to ’ 
\xnn translates to a single byte containing the value of “nn” as expressed in hexadecimal 


\unnnn translates to a pair of bytes containing the value of “nnnn’”as expressed in hexadecimal. 
This form of string escape is only valid where the resultant string data is 16-bits in length, e.g. 
the L" form of string specification. 


If a sequence not listed above is encountered, the interpreting device shall reject the entire 
string and indicate an error. EDS files shall only contain escape sequences defined above. 


7-3.5.5 ASCII Unsigned Integer Convention - (USINT, UINT, UDINT, ULINT) 


The unsigned integer data types represent positive integer values. Unsigned integer data may be 
entered in decimal or hexadecimal notation with no white space or commas between characters. 
If hexadecimal notation represents the unsigned integer characters, the two character sequence 
Ox, with no white space, shall precede the unsigned integer characters. 


The range of legal USINT data is: 
Decimal Notation: 0 to 255 
Hexadecimal Notation: 0x0 to OxFF 


The range of legal UINT data is: 
Decimal Notation: 0 to 65535 
Hexadecimal Notation: 0x0 to OxFFFF 


The range of legal UDINT data is: 


Decimal Notation: 0 to 4294967295 
Hexadecimal Notation: 0x0 to OxFFFFFFFF 

The range of legal ULINT data is: 
Decimal Notation: 0 to 18446744073709551615 
Hexadecimal Notation: 0x0 to OxFFFFFFFFFFFFFFFF 


7-3.5.6 ASCII Signed Integer Convention - (SINT, INT, DINT, LINT) 


The SINT, INT, DINT and LINT data types represent signed integer data values. Signed 
integer data may be entered in decimal or hexadecimal notation with no white space or commas 
between characters. If hexadecimal notation represents the signed integer characters, the two 
character sequence Ox, with no white space, shall precede the integer value characters. 


The range of legal SINT data is: 


Decimal Notation: -128 to 127 
Hexadecimal Notation: 0x80 to Ox7F 
The range of legal INT data is: 
Decimal Notation: -32768 to 32767 
Hexadecimal Notation: 0x8000 to Ox7FFF 
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The range of legal DINT data is: 


Decimal Notation: -2147483648 to 2147483647 
Hexadecimal Notation: 0x80000000 to Ox7FFFFFFF 
The range of legal LINT data is: 
Decimal Notation: -9223372036854775808 to 9223372036854775807 
Hexadecimal Notation: 0x8000000000000000 to 0x7 FFFFFFFFFFFFFFF 


7-3.5.7 ASCII Word Convention - (BYTE, WORD, DWORD, LWORD) 


The BYTE, WORD, DWORD and LWORD data types represent bit-addressable values. These 
values are considered discrete bit position values and are not intended to represent either signed 
or unsigned integer values. However, these values, for convenience, may be entered in 
decimal, hexadecimal or binary notation with no white space or commas between characters. If 
hexadecimal notation represents value characters, the two character sequence Ox, with no white 
space, shall precede the value characters. 


The range of legal BYTE data is: 


Decimal Notation: 0 to 255 

Hexadecimal Notation: 0x0 to OxFF 

Binary Notation: 0b00000000 to 0b11111111 
The range of legal WORD data is: 

Decimal Notation: 0 to 65535 

Hexadecimal Notation: 0x0 to OxFFFF 

Binary Notation: 0b0000000000000000 to 0b1111111111111111 
The range of legal DWORD data is: 

Decimal Notation: 0 to 4294967295 

Hexadecimal Notation: 0x0 to OxFFFFFFFF 

Binary Notation: 0b00000000000000000000000000000000 to 


0b11111111111111111111111111111111 
The range of legal LWORD data is: 


Decimal Notation: 0 to 18446744073709551615 
Hexadecimal Notation: 0x0 to OxFFFFFFFFFFFFFFFF 
Binary Notation: 0b00000000000000000000000000000000- 


00000000000000000000000000000000 to 
0b11111111111111111111111111111111- 
11111111111111111111111111111111 


7-3.5.8 CIP Path 


The CIP path string, having the type STRING, follows the format defined in this specification. 
The CIP path consists of groups of two adjacent hexadecimal characters separated by spaces. 
Double quotes enclose the entire string. Some example path strings are: 


Path Ex.1: “20 04 24 01” 
Path Ex.2: “20 05 24 02 30 04” 
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The CIP Path string may also include the keyword Param entries. Param entries in CIP Paths 
shall evaluate to a USINT, UINT or UDINT. The value of the Param shall be used in a little 
endian order for insertion into the path. The Param references within the path may be enclosed 
in brackets as shown in Path ex. 3. When enclosed in brackets, the value of the Param shall be 
local to the path — the same Param entry may have a different value elsewhere in the EDS. If 
the Param is not enclosed in brackets, the value shall be the same everywhere within the EDS. 


Path Ex. 3: “20 04 24 [Param1] 30 03” 


The user interface may ask the user to specify a value for Param1. If the user specifies “5” the 
resulting CIP path would be “20 04 24 05 30 03”. 


The CIP Path string may also include the keyword, SYMBOL_ANSI. When SYMBOL_ANSI 
in encountered it shall evaluate to an extended symbolic segment (see Appendix C) entered 
through the user interface. The extended symbol segment shall be an ANSI extended symbol 
(CIP path type = 0x91). For example, the string "CAB" shall evaluate to the following 
extended symbol segment (padded): 0x91 0x03 0x43 0x41 0x42 0x00. 


Path Ex. 4: “SYMBOL_ANSI” 


The user interface shall ask the user to specify a symbol string (like “CAB”) which results in a 
CIP Path of “91 03 43 41 42 00”. 


7-3.5.9 STRINGI 


The CIP International String (STRINGI) data follows the format as defined in Volume I, 
Appendix C of the specification. The STRINGI is specified in an EDS file as a complex data 
representation. The entire content of the STRINGI specification is enclosed in a pair of braces. 
Each language specification within the STRINGI entry is also enclosed in a pair of braces. The 
members of each STRINGI entry are specified as 6 fields. The first three fields (the language 
selection) are expressed as exactly a three character fixed length string enclosed in double 
quotation marks. The data type EPATH is expressed in the string form of an EPATH (as 
described above). The character set selection is expressed as a UINT. The string content 
portion of the entry is expressed as a string or long string. For example, the following 
represents a STRINGI specification with three languages: 


Field1 = { 3, 


{"eng",0xD0,4,"This is an ASCII English language string"}, 
{"spa",0xD5,1000,L"Espafioles palabras"}, $ “Spanish words” using UNICODE 
{"deu",OxD0,4, "Spanische Worter auf Deutsch"} $ “Spanish words in German” 


}; 
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7-3.5.10 EDS Comments 


Comments must be delimited with the dollar sign character ($) and the new line character. The 
EDS interpreter treats all characters between the comment delimiters as white space. Some 
example comments are: 


$ This is a valid comment line <NL> 
1, 2, 3; $ This is a valid comment <NL> 


$ Comments cannot span <NL> 
more than one line <NL> <= This is an error - no $ 


7-3.5.11 EDS Date 


The EDS_DATE data type shall be of the format; mm-dd-yyyy, where mm is the month, dd is 
the day of the month and yyyy is the year. Valid values for the month, day and year portions of 
the mm-dd-yyyy shall be 


e mm _ 01 through 12 
e dd 01 through 31 (depending upon the month and year) 
e yyyy 1994 through 9999. 


Two character years representations may be used in which case the EDS_DATE data type shall 
be of the format; mm-dd-yy, where mm is the month, dd is the day of the month and yy is the 
year. In this case, the two digits for the year have an implied leading 19, such that yy=96 shall 
represent the year 1996. Valid values for the month, day and year portions of the mm-dd-yy 
parameters shall be: 


e mm _ 01 through 12 
e dd 01 through 31 (depending upon the month and year) 
e yy 94 through 99 (Note that a leading 19 is implied) 


NOTE: Two character year representations are not recommended. 


7-3.5.12 EDS Time Of Day 


The EDS_TIME_OF_DAY data type shall be of the format; hh:mm:ss, where hh is hours, mm 
is minutes and ss is seconds. Valid values for the hours, minutes and seconds shall be: 


e hh — 00 through 23 
e mm _ 00 through 59 
e ss 00 through 59 
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7-3.5.13 ASCII Floating Point Convention (REAL, LREAL) 


The REAL and LREAL data types represent binary floating-point values. The internal 
representation of these data formats is described by the IEEE Standard 754. This standard 
describes both numeric values and bit sequences which are interpreted as “Not a Number” 
(NaN) symbolic values and positive and negative infinity. The floating point values can be 
entered as either integer values, values based upon decimal floating point representation, or 
values entered in “scientific” notation using a base value and an offset in exponential form. 
Integer values are the same as those shown for the INT data type. These value can not be used 
to represent fractional values. Decimal floating-point values are those, which have both a 
whole integer and fractional component. The whole value and fractional components are 
separated by a decimal point “.” or period character. The exponential (scientific) notation form 
of the value is the same as the fractional value representation with the addition of an 
exponential component. This exponent is always a signed integer power to ten applied to the 
base value. 


The range of legal REAL data (single IEEE, 32 bit format) is based upon the formula: 
value = (-1)s*(2)e-127*(m) 


Where: 


e “s” is the value of the sign bit 

e “e” is the eight bit exponent. This exponent allows an approximate exponent range 
between 0 and 8.5e””. 

e “m” is the normalized 24-bit mantissa (23 internal to the storage plus one hidden bit). This 
allows a range of mantissa values to range between 0 and 8388607. 


Since the mantissa of the floating-point representation only allows a value digit value to be 
precisely represented by the internal format, a large number of digits within the decimal (or 
mantissa) portion of a floating value is more for presentation convenience than precision. An 
arbitrary limit of 16 digits has been set for the CIP standard. 


Integer (Fixed) Notation: -8388607 to 8388607 
Decimal (Floating Point) Notation: 0.0 to 9999999999999999 
Scientific Notation: 0.0 to +nn.nnnnnnnnnE+xxxx 


Where the total number of digits in the mantissa (including the decimal point character and sign 
character) shall not exceed 13 characters and the number of characters in the exponent shall not 
exceed 6 characters (including the “E” character and sign character) 


Where: 


e “s” is the value of the sign bit 

e “e” is the eleven-bit exponent. This exponent allows an approximate exponent range 
between 0 and 8.5e”. 

e “m” is the normalized 53-bit mantissa (52 internal to the storage plus one hidden bit). This 
allows a range of mantissa values to range between 0 and 4503599627370495. 
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Since the mantissa of the floating-point representation only allows a value digit value to be 
precisely represented by the internal format, a large number of digits within the decimal (or 
mantissa) portion of a floating value is more for presentation convenience than precision. An 
arbitrary limit of 16 digits has been set for the CIP standard. 


The range of legal LREAL data (double IEEE, 64 bit format) is based upon the formula: 


value = (-1)*(2)°1?«(m) 


Integer (Fixed) Notation: -4503599627370495 to 4503599627370495 
Decimal (Floating Point) Notation: 0.0 to 9999999999999999 
Scientific Notation: 0.0 to tnnnn.nnnnnnnnnnE+xxxx 


Where the total number of digits in the mantissa (including the decimal point character and sign 
character) shall not exceed 18 characters and the number of characters in the exponent shall not 
exceed 6 characters (including the “E” character and sign character) 


In addition to the above value entries, the floating-point representation allows for two styles of 
“Not a Number” or NaN symbolic entries and two forms of infinity. There are two types of 
NaN; a Signaling NaN and a Quiet NaN. Also, the format allows for the representation of the 
values positive and negative infinity. For these cases, the following special words are reserved 
and shall be used to represent the entry of the associated floating-point symbol: 


e Quiet Not a Number: QUIET-NAN 

e Signaling Not a Number: SIGNAL-NAN 

e Positive Infinity: INFINITY (or +INFINITY) 
e Negative Infinity: -INFINITY 


7-3.5.14 EDS_URL Uniform Resource Locator 


All references to EDS_URL within this specification are for the formalized information 
necessary to locate and access resources via an internet capable mechanism. The form of the 
EDS_URL is that defined by the internet's Network Working Group RFC1738 "Uniform 
Resource Locator (URL)". For specifications made within an EDS file, the EDS_URL is 
limited to any of the forms: 


e =http 
e ftp 
e file 
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7-3.6 Basic EDS File Requirements 


This section describes each section of an EDS and specifies the usage requirements. 


Table 7-3.2 Locating EDS Requirements 


For EDS requirements for: Go to section: 
Object Class Sections 7-3.6.1.1 
Parameter Class Section 7-3.6.1.3 
Connection Configuration Class Section 7-3.6.1.4 
File Description Section 7-3.6.2 
Device Description Section 7-3.6.3 
Device Classification Section 7-3.6.4 
Parameters Section 7-3.6.5 
Parameter Groups Section 7-3.6.6 
Assembly Section 7-3.6.7 
Connection Manager Section 7-3.6.9 
Port Section 7-3.6.10 
Modular Section 7-3.7.1 
Capacity Section 7-3.6.11 
Event Enumeration Section 7-3.6.12 
Symbolic Translation Section 7-3.6.13 
Internationalization Section 7-3.6.14 


7-3.6.1 Common Object Class Information 


7-3.6.1.1 Object Class Sections 


The following table identifies section keywords that are used to publicize object class 
information. Each of the following EDS Section Keywords may contain any of the Common 
Object Class Entry Keyword(s) described in 7-3.6.1.2. The following table contains Object 
Class Section names. 


Table 7-3.3 Object Class Section Keywords 


CIP Object Section Keyword Name Required/Optional See section 
Identity Object : . : 
[Identity Class] Optional 
01 hex 
Message Router Object é ; 
[Message Router Class] Optional 
02 hex 
DeviceNet Object 7 
[DeviceNet Class] Optional 
03 hex 
Assembly Object : ; 
[Assembly Class] Optional 
04 hex 
Connection Object : . : 
[Connection Class] Optional 
05 hex 
Connection Manager Object | _ . . 
[Connection Manager Class] Optional 
06 hex 
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CIP Object Section Keyword Name Required/Optional See section 

Register Object Go of ; 
[Register Class] Optional 

07 hex 

Discrete Input Point Object a, , 
[Discrete Input Class] Optional 

08 hex 

Discrete Output Point Object | _. : 
[Discrete Output Class] Optional 

09 hex 

Analog Input Point Object - } 
[Analog Input Class] Optional 

OA hex 

Analog Output Point Object | _ ‘ 
[Analog Output Class] Optional 

OB hex 

Presence Sensing Object : . : 
[Presence Sensing Class] Optional 

OE hex 

Parameter Object : “22 
[ParamClass] Conditional 7-3.6.1.3 

OF hex 

Parameter Group Object x2 F 
[Parameter Group Class] Optional 

10 hex 

Group Object f ; 
[Group Class] Optional 

12 hex 

Discrete Input Group Object | __. ‘ 
[Discrete Input Group Class] Optional 

1D hex 

Discrete Output Group 

Object [Discrete Output Group Class] Optional 

1E hex 

Discrete Group Object eee ; 
[Discrete Group Class] Optional 

1F hex 

Analog Input Group Object 7 : 
[Analog Input Group Class] Optional 

20 hex 

Analog Output Group Object | _ . 
[Analog Output Group Class] Optional 

21 hex 

Analog Group Object : : 
[Analog Group Class] Optional 

22 hex 

Position Sensor Object 7 
[Position Sensor Class] Optional 

23 hex 

Position Controller tic ark ; 

Supervisor Object [Position Controller Supervisor Optional 
Class] 

24 hex 

Position Controller Object Sot pe . 
[Position Controller Class] Optional 

25 hex 

Block Sequencer Object : : 
[Block Sequencer Class] Optional 

26 hex 

Command Block Object - ; 
[Command Block Class] Optional 

27 hex 

Motor Data Object 7 . 
[Motor Data Class] Optional 

28 hex 

Control Supervisor Object [Control Supervisor Class] Optional 
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CIP Object Section Keyword Name Required/Optional See section 

29 hex 

AC/DC Drive Object : : 
[AC/DC Drive Class] Optional 

2A hex 

Acknowledge Handler 

Object [Acknowledge Handler Class] | Optional 

2B hex 

Overload Object = ‘ 
[Overload Class] Optional 

2C hex 

Softstart Object : 
[Softstart Class] Optional 

2D hex 

Selection Object : . : 
[Selection Class] Optional 

2E hex 

S-Device Supervisor Object : . ; : 
[S-Device Supervisor Class] Optional 

30 hex 

S-Analog Sensor Object - : 
[S-Analog Sensor Class] Optional 

31 hex 

S-Analog Actuator Object 7 ; 
[S-Analog Actuator Class] Optional 

32 hex 

S-Single Stage Controller 

Object [S-Single Stage Class] Optional 

33 hex 

S-Gas Calibration Object E 
[S-Gas Calibration Class] Optional 

34 hex 

Trip Point Object Se. . : 
[Trip Point Class] Optional 

35 hex 

Drive Data Object 7 
[Drive Data Class] Optional 

N/A 

File Object _ : 
[File Class] Optional 

37 hex 

S-Partial Pressure Object 7 
[S-Partial Pressure Class] Optional 

38 hex 

ControlNet Object 7 , 
[ControlNet Class] Optional 

FO hex 

ControlNet Keeper Object 7 : 
[ControlNet Keeper Class] Optional 

F1 hex 

ControlNet Scheduling 

Object [ControlNet Scheduling Class] | Optional 

F2 hex 

Connection Configuration 

Object [Connection Configuration] bs 7-3.6.1.4 

Conditional 

F3 hex 

Port Object ; 
[Port Class] Optional 

F4 hex 

TCP/IP Interface Object ; 
[TCP/IP Interface Class] Optional 


F5 hex 
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CIP Object Section Keyword Name Required/Optional See section 
EtherNet Link Object 
F6 hex 


[Ethernet Link Class] Optional 


7-3.6.1.2 Common Object Class Entry Keywords 


Every CIP object has certain characteristics that are described by the following common Object 
Class Section entry keywords. These keywords may be used in any Object Class Section (see 
chapter 7-3.6.1.1). 


Table 7-3.4 Common Object Class Entry Keywords 


Entry Name Entry Keyword Required/Optional 

Revision Revision Required 
Maximum Instance Number MaxiInst Required 
Number of Static Instances Number_Of_Static_Instances Required 
Maximum Number of Dynamic Max_Number_Of_Dyamic_Instances Required 
Instances 

Class attribute identification Class_ Attributes Optional 
Instance attribute identification Instance_Attributes Optional 
Class service support Class_Services Optional 
Instance service support Instance Services Optional 


7-3.6.1.2.1 Revision Entry Keyword 


The “Revision” entry keyword corresponds to the class attribute #1 (Revision). The “Revision” 
entry keyword shall contain the field shown in Table 7-3.5. 


Table 7-3.5 Revision Entry Keyword Format 


Field Name Field Number Data Type Required/Optional 
Revision 1 UINT Required 


7-3.6.1.2.1.1 Revision, Field 1 


This entry field contains the value that shall match the value of the object’s Revision class 
attribute (attribute #1). 


7-3.6.1.2.2. MaxInst Entry Keyword 


The “MaxInst” entry keyword identifies the maximum instance number of the class. The 
“MaxInst” entry keyword shall contain the field shown in Table 7-3.6. 


Table 7-3.6 MaxInst Entry Keyword Format 


Field Name Field Number Data Type Required/Optional 
MaxiInst 1 UINT Required 
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7-3.6.1.2.2.1 MaxInst, Field 1 
This entry field contains the value that identifies the maximum (numerically largest) instance 
number of the class. 

7-3.6.1.2.3 Number_Of_Static_Instances Entry Keyword 


The “Number_Of_Static_Instances” entry keyword identifies the total number of static 
instances of the object. The “Number_Of_Static_Instances” entry keyword shall contain the 
field shown in Table 7-3.7. 


Table 7-3.7 Number_Of_Static_Instances Entry Keyword Format 


Field name Field Number Data type Required/Optional 
Number of static instances 1 UINT Required 
7-3.6.1.2.3.1 | Number_Of_Static_Instances, Field 1 


This entry field contains the value that identifies the total number of static instances of the 
object in the device. 


7-3.6.1.2.4 Max_Number_Of_Dynamic_Instances Entry Keyword 


The “Max_Number_Of_Dynamic_Instances” entry keyword identifies the maximum number 
of dynamic instances of the object capable of being created in the device. The 
“Max_Number_Of_Dynamic_Instances” entry keyword shall contain the field shown in Table 
7-3.8. 


Table 7-3.8 Max_Number_Of_Dynamic_Instances Entry Keyword Format 


Field name Field Number Data type Required/Optional 


Maximum number of 1 UINT Required 
dynamic instances 


7-3.6.1.2.4.1 Maximum Number_Of_Dynamic_Instances Entry Keyword, Field 1 


This entry field contains the value that identifies the total number of dynamic instances of the 
object capable of being created in the device. 


7-3.6.1.2.5  Class_Attributes Entry Keyword 


The “Class_Attributes” entry keyword is used to identify attributes within an object class 
(instance number zero) . The “Class Attributes” entry keyword shall contain the fields shown 
in Table 7-3.9. 
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Table 7-3.9 Class_Attributes Entry Keyword Format 


Field name Field Number Data type Required/Optional 
Attribute ID 1 1 UINT Required 
Attribute ID 2 2 UINT Conditional 
Attribute ID n N UINT Conditional 
7-3.6.1.2.5.1 Attribute ID Entry Keyword, Field 1 thru n 


These entry fields shall contain values that identify attributes of the object’s class in the device. 
Each field in the list indicates an attribute that has been implemented in the object’s class. The 
total number of fields is variable based upon the actual number of attributes implemented. No 
null fields are allowed. 


7-3.6.1.2.6 Instance_Attributes_Entry_Keyword 


The “Instance_Attributes” entry keyword is used to identify attributes within a class instance 
(non-zero instance number). The “Instance Attributes” entry keyword shall contain the fields 
shown in Table 7-3.10. 


Table 7-3.10 Instance_Attributes Entry Keyword Format 


Field name Field Number Data type Required/Optional 
Attribute ID 1 1 UINT Required 
Attribute ID 2 2 UINT Conditional 
Attribute ID n N UINT Conditional 
7-3.6.1.2.6.1 Attribute ID Entry Keyword, Field 1 thrun 


These entry fields shall contain values that identify attributes of the object’s instance(s) in the 
device. Each field in the list indicates an attribute that has been implemented in the object’s 
instance(s). The total number of fields is variable based upon the actual number of attributes 
implemented. No null fields are allowed. 


7-3.6.1.2.7. | Class and Instance Services Entry Keyword Fields 


The class and instance services keywords require a new field value type defined here. The 
name of this field type is Service 


The following are the forms of the Service field: 


e Service ID — Indication of non-attribute specific service ID code 

e {Service ID, AttrId1, AttrId2, AttrId3, ...} — Indication of a service ID code and associates 
attribute identifiers to which the service is accepted. 

e = {Service ID, *} — Indication of a service ID code and associates every attribute listed in the 
corresponding Class_Attributes/Instance_Attribute list. 
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7-3.6.1.2.7.1.1 
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The “Class_Services” entry keyword is used to identify services within an object class 
(instance number zero). The “Class Services” entry keyword shall contain the fields shown in 


Table 7-3.11. 


Table 7-3.11 Class_Services Entry Keyword Format 


Field name Field Number Data type Required/Optional 
Service 1 1 Service Required 
Service 2 2 Service Conditional 
Service n N Service Conditional 


Class Services Entry Keyword, Field 1 thru n 


These entry fields shall contain values that identify services of the object’s class in the device. 
Each field in the list indicates a service that has been implemented in the object’s class. The 
total number of fields is variable based upon the number of services implemented. No null 


fields are allowed. 


Instance_Services Entry Keyword 


The “Instance_Services” entry keyword is used to identify services within a class instance 
(non-zero instance number). The “Instance Services” entry keyword shall contain the fields 
shown in Table 7-3.12. 


Table 7-3.12 Instance_Services Entry Keyword Format 


Field name Field Number Data type Required/Optional 
Service 1 1 Service Required 
Service 2 2 Service Conditional 
Service n n Service Conditional 
7-3.6.1.2.7.2.1 | Instance Services Entry Keyword, Field 1 thru n 


These entry fields shall contain values that identify services of the object’s instance(s) in the 
device. Each field in the list indicates a service that has been implemented in the object’s 
instance(s). The total number of fields is variable based upon the number of services 
implemented. No null fields are allowed. 


7-3.6.1.3 Parameter Class Section 


The parameter class section begins with the keyword [ParamClass]. The purpose of this section 
is to: 


e identify the class level attributes of the configuration parameters 


e contain a subset of the Parameter Object class attributes as defined in the CIP Object 
Library 
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The following table identifies then entry keywords in the parameter class section: 


Table 7-3.13 Entry Keywords in the Parameter Class Section 


Entry Name Required/Optional 
Revision Optional * 
Number of Static Instances Optional ” 
Maximum Number of Dynamic Optional ” 
Instances 
Parameter Class Descriptor Required 
Configuration Assembly Instance Required 
Safety Assembly Instance Conditional * 


1 - This keyword is not allowed if the device is not a safety device. If the device is a safety device, 
see Volume 5. 


2 — This keyword, although defined in section 7-3.6.1.2 Common Object Class Entry Keywords as 
Required, is Optional in the [ParamClass] section. 


e Parameter Class Descriptor - Contains bit flags that describe the behavior of the device’s 
parameter objects. 

e Configuration Assembly Instance - Identifies the configuration assembly object instance 
number for parameters associated in this EDS and defined in the CIP Object Library. 

e Safety Assembly Instance — This entry keyword is a safety-specific keyword. Use of this 
entry keyword is described in the CIP Safety Volume 


Figure 7-3.6 Sample Electronic Data Sheet Illustrating the Parameter Class Section 


[File] 
[Device] 


[ParamClass] 
Revision = 1; 
MaxInst = 3; 
Number_Of_Static_Instances = 3; 
Max_Number_Of_Dynamic_Instances = 0; 
Descriptor = Ox0E; 
CfgAssembly = 3; 


[Params ] 


[Groups] 
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7-3.6.1.4 Connection Configuration Class Section 


The Connection Configuration section defines the characteristics of the Connection 
Configuration Object (see Object Library, Chapter 5) implemented in this device, if a 
Connection Configuration Object implementation exists. The Common Object Class keywords 
may be used in the Connection Configuration section, see chapter 7-3.6.1. The table below 
shows the additional entries in the Connection Configuration section. The Connection 
Configuration Class section begins with the keyword [Connection Configuration]. This section 
is required if the device supports the Connection Configuration object. 


Table 7-3.14 Entry Keywords in the Connection Configuration Section 


Connection 


Entry Name Entry Keyword Required/Optional 
Number of Static Number_Of_Static_Instances Optional t 
Instances 
Maximum Number of Max_Number_Of_Dynamic_Instances | Optional 
Dynamic Instances 
Mapping Attribute MappingFormat Required 
Format 
Originator to Target O2Timages Required 
Image Sizes and Paths 
Target to Originator T2OImages Required 
Image Sizes and Paths 
Redundant Owner RedundantOwnerConnections Optional 


1 — This keyword, although defined in section 7-3.6.1.2 Common Object Class Entry 
Keywords as Required, is Optional in the [Connection Configuration] section. 


7-3.6.1.4.1 Mapping Attribute Format Number Entry Keyword 


The “MappingFormat” entry keyword shall contain the formatted field shown in Table 7- 
3.15. 


Table 7-3.15 MappingF ormat Keyword Format 


Field name Field Number Data type Required/Optional 
Format 1 UINT Required 


7-3.6.1.4.1.1 Format, Field 1 
The format number of the mapping attribute (class attribute 8) supported by this device’s 
implementation of the Connection Configuration Object. 

7-3.6.1.4.2 Originator to Target Image Sizes and Paths Entry Keyword 


The "O2TImages" entry keyword shall contain the formatted field shown in Table 7-3.16. 
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Table 7-3.16 O2TImages Keyword Format 


Field Name Field Number Data Type Required/Optional 
| Reserved 1,2 empty 
| Image Size S33 fjord UINT Field 3 is required. Fields 5, 7... are 
conditional based on the existence of 
additional image tables. 
| Image EPath 4,6,8,... EPath Optional 
7-3.6.1.4.2.1 Reserved, Field 1 


Field 1 shall be reserved for future definition and shall be empty. 


7-3.6.1.4.2.2. Reserved, Field 2 


Field 2 shall be reserved for future definition and shall be empty. 


7-3.6.1.4.2.3 Image Size 


The number of 8 bit units in the Originator to Target image table. Field 3 specifies the size of 
Originator to Target image table 1. Field 5 specifies the size of Originator to Target image 
table 2, etc. 


7-3.6.1.4.2.4 Image Path 


The EPath is a logical or symbolic segment used to access the Originator to Target image table. 


Field 4 specifies the EPath used to access the Originator to Target image table 1. Field 6 
specifies the EPath used to access the Originator to Target image table 2, etc. 


7-3.6.1.4.3 


Target to Originator Image Sizes and Paths Entry Keyword 


The "T2OImages" entry keyword shall contain the formatted field shown in Table 7-3.17. 


Table 7-3.17 T2OImages Keyword Format 


Field Name Field Number Data Type Required/Optional 
Reserved 1,2 empty 
Image Size 33D; Lyeae UINT Field 3 is required. Fields 5, 7... are conditional 
based on the existence of additional image tables. 
Image EPath 4,6,8,... EPath Optional 


7-3.6.1.4.3.1 


Reserved, Field 1 


Field 1 shall be reserved for future definition and shall be empty. 


7-3.6.1.4.3.2 


Reserved, Field 2 


Field 2 shall be reserved for future definition and shall be empty. 
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7-3.6.1.4.3.3 Image Size 


The number of 8 bit units in the Target to Originator image table. Field 3 specifies the size of 
Target to Originator image table 1. Field 5 specifies the size of Target to Originator image table 
2, etc. 


7-3.6.1.4.3.4 Image EPath 


The EPath is a logical or symbolic segment used to access the Target to Originator image table. 
Field 4 specifies the EPath used to access the Target to Originator image table 1. Field 6 
specifies the EPath used to access the Target to Originator image table 2, etc. 


7-3.6.1.4.4 Connection Target Name Entry Keyword 


Each entry keyword shall be “ConnectionTarget” combined with a number (decimal), for 
example, “ConnectionTarget1”. The number (decimal) shall be used to locate the 
corresponding “Connection” entry in the Connection Manager section of this device. One 
Connection Target Name entry may exist for each Connection entry specified in the 
Connection Manager section. If no ConnectionTarget entry corresponding to a Connection 
entry exists, the name from the Connection entry shall be used for the target entry name. The 
“ConnectionTargetName” keyword shall contain the formatted field shown in Table 7-3.18. 


Table 7-3.18 ConnectionTarget Entry Keyword Format 


Field Name Field Number Data Type Required/Optional 
Name 1 Eds_Char_Array Required 
International Name 2 STRINGI Optional 
7-3.6.1.4.4.1 | Name, Field 1 


The name to display for the target entry that corresponds to the connection specified in the 
Connection Manager section by a Connection entry. 


7-3.6.1.4.4.2 International Name, Field 2 


The connection target name expressed in STRINGI notation. 


7-3.6.1.4.5 | Redundant Owner Connection Support Entry Keyword 


The "RedundantOwnerConnections" entry keyword is optional and shall contain the 
formatted field shown in Table 7-3.19. If this optional keyword is omitted, redundant 
connections can not be originated. 


Table 7-3.19 RedundantOwnerConnections Keyword Format 


Field name Field Number Data type Required/Optional 


Supported 1 Field Keyword, possible Required 
values: Yes, No 
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7-3.6.1.4.5.1 Supported, Field 1 


This field indicates if redundant owner connections can be originated. If the field value is 
“Yes”, redundant connections can be originated. If the field value is “No”, redundant 
connections can not be originated. When redundant owner connections can be originated, as 
few as zero of the connections being originated, and as many as all the connections being 
originated may be redundant owner connections. 


7-3.6.1.4.5.1.1 | Example Connection Configuration Section 


The following is an example of a [Connection Configuration] section: 


Figure 7-3.7 Sample Electronic Data Sheet Illustrating the Connection Configuration Class 
Section 


$ The following EDS section describes a device that supports the 3” 
$ revision of Connection Configuration Object. The following are the 
$ characteristics of this Connection Configuration Object implementation: 


$ 

$ The maximum number of Connection Configuration Object instances 

$ (connections or targets) that can be created is 128. 

$ The Originator to Target Image (output) size is 4000 bytes long. The 
$ Originator to Target Image can be read by performing a Get_Member 

$ service to instance one of the Assembly Object (attribute 3). 

$ The Target to Originator Image (input) size is 4000 bytes long. The 

$ Target to Originator Image can be read by performing a Get_Member 

$ service to instance two of the Assembly Object (attribute 3). 

$ The name of a connection to this device is “Consume Data From”, the 

$ connection path is “20 04 24 01 2C 01 2C 02”. If a target for a 

$ connection to this device is created it shall be called “Send Data”. 
$ This device does not support origination of Redundant Owner connections. 
$ The Connection Configuration Object Open_Connection, Close_Connection 
$ and Stop_Connection instance services are supported. 

$ The ability to change this devices mode is supported by using the 

$ Set_Attribute_Single service to the Connection Configuration Object 
$ class attribute 0x33. 

[File] 

[Device ] 


[Connection Configuration] 
Revision = 3; revision of the Connection Configuration object 
supported in this device 
Format of mapping attribute 
(class attribute 8) 
maximum number of connection configuration 
object instances supported 
O2TImages = ,,4000,”20 04 24 01 30 03”; 
$ 4000 bytes of output image, path of output 
$ image table 
,, 4000, “20 04 24 02 30 03”; 
$ 4000 bytes of input image, path of input 
$ image table 
ConnectionTargeti = “Send Data”; 
$ target name corresponding to Connection1 


MappingFormat = 0; 


MaxInst = 128; 


APRA AFAAH 


T20Images 
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RedundantOwnerConnections = No; 
$ redundant output owner connections not 
$ supported 

Number_Of_Static_Instances = 0; 


Max_Number_Of_Dynamic_Instances = 128; 

Instance_Services = 0x4C, Open_Connection, 
©x4D, Close_Connection, 
Qx4E; Stop_Connection, 


al 
$ 
$ 
$ 
$ services to instances supported 
Class Services = {0x10, 33}; $ Set_Attribute_Single service to 
$ attribute 
$ 0x33 supported (set scanner mode) 
[Assembly Class] 
Revision = 2; 
MaxInst = 177; 
Number_Of_Static_Instances = 14; 
Max_Number_Of_Dynamic_Instances = 0; 
Instance_Services = 0x18; $ Get_Member service to instances 
$ supported (read of input and output 
$ image tables supported) 


[Connection Manager ] 


Connectioni = 

0x02010002, trigger and transport 
0x44244305, connection parameters 
19,, O->T RPI, size and format 
14, T->0 RPI, size and format 


config part 1 
config part 2 
connection name 
help string 
connection path 


vr 


vr 
“Consume Data From”, 


an 


y 
“20 04 24 01 2C 01 2C 02”; 


PRAHA AHFAHAH HF 


7-3.6.2 File Description Section 


The file description section begins with the keyword [File] and contains administrative 
information about the EDS file. A configuration tool reads this information, formats it, and 
displays it to the user. The user can also access this section with a text file viewer and display 
the unformatted information. This section requires no modification unless the user manually 
modifies the file. The file description section must contain: 


Table 7-3.20 Fields in the File Description Section 


Entry Name Entry Field Data Type Required/Optional 
Keyword | Number 


File Description Text Required 
File Creation Date Required 
File Creation Time Required 
Last Modification Date Conditional 
Last Modification Time Conditional 
EDS Revision Required 


— 7-39 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 7: Electronic Data Sheets 


Entry Name Entry Field Data Type Required/Optional 
Keyword | Number 


EDS File CRC EDSFileCRC | See CIP Safety Specification Conditional 1 
(Volume 5, Chapter 7) 


1- This keyword is not allowed if the device is not a safety device. If the device is a safety device, see 
Volume 5. 


The entries in the file description section provide: 


File Description Text - a single line of text displayed by the configuration tool. The EDS 
developer assigns a meaningful line of text for this entry. Double quotes enclose all 
character arrays. 

File Creation Date - the creation date of the EDS, assigned by the EDS developer. 
Provided only for convenience, you can use this date to get version information about the 
file. A configuration tool does not use this information to perform any type of version 
control, but it may display the contents. 

File Creation Time - the creation time of the EDS, assigned by the EDS developer. 
Provided only for convenience, you can use this date to get version information about the 
file. A configuration tool does not use this information to perform any type of version 
control, but it may display the contents. 

Last Modification Date - the date of the last modification to the EDS. A configuration 
tool that allows modification of the EDS file shall update this field as needed. Provided 
only for convenience, the configuration tool displays the contents of this entry if it exists. If 
a configuration tool changes the EDS, the configuration tool shall update this field. 
However, if you modify the EDS manually or with a text editor, you should also update 
this field. 


This keyword is required if either: 


e the EDS file is modified by a software tool, or 

e the Last Modification Time keyword is present 

Last Modification Time - the time of the last modification to the EDS. A configuration 
tool that allows modification of the EDS file must update this entry as needed. Provided for 
convenience, the configuration tool displays the contents of this entry if it exists. If a 
configuration tool changes the EDS, the configuration tool must update this field. 
However, if you modify the EDS manually or with a text editor, you should also update 
this field. 

EDS Revision - the revision of the EDS. The EDS revision is not required to have any 
relationship to the product’s revision, it is simply the revision of the EDS file itself. The 
revision must be formatted as: 


major_revision.minor_revision 


For example: 2.1 <= major revision is 2, and minor revision is 1 


Home URL — Uniform Resource Locator of the master EDS file, the Icon file and other 
files related to this EDS. The Home URL shall specify a complete qualified URL for 
referencing a master version of the EDS file. In addition, the referenced area (without the 
file name specification) is used to specify an area where other related file(s) relating to the 
device described by this EDS are contained. 
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e Exclude — This keyword, when present, indicates that the manufacturer of the device 
expects a specific behavior by the configuration tool if that tool encounters any items 
(section keywords, entry keywords, field values, etc), which are not understood. The 
behavior modification of the tool is defined as which type of operations shall be excluded 
when any items, which are not understood are encountered. This keyword has a single 
required field with the following allowed values: “NONE”, “WRITE”, “READ_WRITE”. 
Each word shall be interpreted as: 

e NONE - No behaviors are excluded. 

e WRITE - All write access to the device shall be excluded (e.g. no 
Set_Attribute_Single, Set_Member, etc. service shall be performed). The configuration 
tool shall also exclude configuring a second device, which results in the second device 
writing to the device described by this EDS. 

e READ_WRITE - All access to the device is excluded (e.g. no Get_Attribute_Single, 
Get_Member, etc. service shall be performed). The configuration tool shall also 
exclude configuring a second device, which results in the second reading from or 
writing to the device described by this EDS. 


If the Exclude keyword does not exist in the EDS file, Exclude = NONE is the default. 


When a software tool prevents writing or reading/writing a device due to the Exclude 
keyword messages shall be displayed by the software tool indicating why the operation is 
excluded. The following text strings shall be used: 


e When excluding writing a device because the software tool does not understand a 
vendor specific item (section keywords, entry keywords, field values, etc) — “This 
device cannot be configured because the device supports some vendor-specific 
behavior that is not supported by this software.” 

e When excluding writing a device because the software tool does not understand an 
open item (section keywords, entry keywords, field values, etc) — “This device cannot 
be configured because this software does not support a CIP defined entry described in 
this devices’ EDS file. Contact the vendor of this software for an updated version.” 

e When excluding reading/writing a device because the tool does not understand a 
vendor specific item (section keywords, entry keywords, field values, etc.) — “The 
configuration for this device cannot be displayed because the device supports some 
vendor-specific behavior that is not supported by this software.” 

e When excluding reading/writing a device because the tool does not understand an open 
item (section keywords, entry keywords, field values, etc.) — “The configuration for 
this device cannot be displayed because this software does not support a CIP defined 
entry described in this devices’ EDS file. Contact this vendor of the software for an 
updated version.” 

e When multiple conditions apply, (both vendor specific and open items are not 
understood) the tool shall display both text strings. 
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Figure 7-3.8 Sample Electronic Data Sheet Illustrating the File Section 


[File] 
DescText = "Smart Widget EDS File"; 
CreateDate = 04-03-1994; $ created 
CreateTime = 17:51:44; 
ModDate = 04-06-1994; $ last changed 
ModTime = 22:07:30; 
Revision = 2.1; $ Revision of EDS 


HomeURL = “http://www. odva.org/EDS/example.eds”; 
[Device] 
[Paramclass] 
[Params] 


[Groups ] 


7-3.6.3 Device Description Section 


The Device Description section begins with the keyword [Device] and contains a 
manufacturer’s information about the device, including some of the same values in a device’s 
Identity Object. The table below shows the entries in the device description section. 


Table 7-3.21 Fields in the Device Description Section 


i Required/ 
Entry Name Entry Keyword’ Find Data Type q 
Number Optional 


Vendor ID*” UINT Required 
Vendor Name SCII Character Array Required 
Device Type”® UINT Required 
Device Type String SCI Character Array Required 
Product Code”? UIN Required 
Major Revision”? U Required 
Minor Revision” U Required 
Product Name” ASCII Character Array Required 
Catalog Number ASCII Character Array Optional 


Exclude from Adapter ExcludeFromAdapterR ASCII Character Array Optional 
Rack Connection ackConnection 


Device Status Assembly | DeviceStatusAssembly 1 


1 - The SerNum and Comment entry keywords have been obsoleted 


| 


| 


1 
1 ASCII Character Array Optional 
UINT Optional 


> 
WN WN) = {| 
Z| 2/5 
44 


2 - This entry represents an attribute of the Identity Object 


3 - This entry is used to match an EDS with a specific product/revision 


The entry name for the device description field describes the unique data entry line number. A 
configuration tool uses the required entries in the device description section to match the EDS 
to the device being configured. The entries in the device description section provide: 


e Vendor ID - Numeric vendor identifier as defined by the Identity Object, Attribute 1. 
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e Vendor Name - Textual vendor name. When displayed, truncation may occur to meet the 
display capabilities. 

e Device Type - Numeric device identifier as defined by the Identity Object, Attribute 2. 

e DeviceType String - Textual description of device type exactly as shown in CIP Common, 
Chapter 6-7. The string for vendor specific device types is at the vendors’ discretion. 

e Product Code - Vendor assigned numeric product code identifier as defined by the 
Identity Object, Attribute 3. Each product code shall have its own EDS. 

e Major Revision - Vendor-assigned major revision number as defined by the Identity 
Object, Attribute 4. The major revision of a product is typically incremented when there is 
a change to the form, fit, or function of the device. Changes to major revisions are used by 
a configuration tool to match a device to an EDS. 

e Minor Revision - Vendor-assigned minor revision number as defined by the Identity 
Object, Attribute 4. The minor revision number is used to identify changes in a product 
that do not effect user configuration choices. For example: firmware bug fixes, an 
additional LED, internal hardware changes, etc. Changes in minor revisions are not used 
by a configuration tool to match a device with an EDS. 

e Product Name - Textual product name as defined by the Identity Object, Attribute 7. 
When displayed, truncation may occur to meet the display capabilities. 

e Catalog Number - Textual catalog or model number. One or more catalog numbers may 
be associated with a particular product code. In the case of multiple catalog numbers, it is 
still useful to provide as much of the catalog number as is practical. For example, 1438- 
BAC7xx where ‘xx’ represents variants in the catalog number supported by this product 
code/EDS. 

e ExcludeFromAdapterRackConnection - This field is used to describe if a rack-based 
device must be excluded from an adapter rack connection. If the field value is the string 
“Yes” this module shall be excluded from adapter rack connections by resetting the 
associated slot mask bits (input, output and configuration). If the field value is the string 
“No” or this optional field is omitted the associated slot mask bits may be set. 

e Icon File Name- File name of an Icon file. Identifies a file that contains a graphical 
representation of the device. The file shall have the *. ICO MSWindows format, and shall 
minimally contain a 16x16 icon. The file may also contain 32x32, 48x48, and 64x64 icons. 
The location of the Icon file is the combination of the location specified by the HomeURL 
keyword (without the HomeURL file name component) and the file name specified by this 
keyword. This keyword shall only be present when a HomeURL keyword exists. 

e Device Status Assembly — Identifies the value (N) of the AssemN that defines the format 
and enumerations of the Identity Object status attribute. 
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Figure 7-3.9 Sample Electronic Data Sheet Illustrating the Device Description Section 


[File] 

[Device] 
VendCode = 65535; 
VendName = 


"Widget-Works, Inc."; 
ProdType = 0; 
ProdTypeStr = “Generic”; 
ProdCode = 42; 
MajRev = 1; $ Device Major Revision 
MinRev = 1; $ Device Minor Revision 
ProdName = "Smart-Widget"; 
Catalog = “1499-DVG”; 
Icon = “example.ico”; 
[ParamClass] 


[Params] 


[Groups] 


7-3.6.4 Device Classification Section 


The Device Classification section begins with the keyword [Device Classification] and shall 
classify the device described by the EDS into one or more categories of devices. The entry 
keyword for all classifications shall consist of the character array, "Class", combined with a 
decimal number. The numbers shall start at 1 for the first class, and shall be incremented for 
each additional class. Commas shall separate all fields, and a semicolon shall indicate the end 
of the entry. 


The number of fields for each classification entry shall be variable to allow a tree classification 
structure similar to a file systems directory structure. Sub-classification of the public 
classifications shall be reserved. Vendor-specific classifications may be sub-classified at the 
discretion of the vendor. The first field shall represent the highest level in the tree structure and 
shall be one of the following: 


e CompoNet; 

e ControlNet; 

e DeviceNet; 

e EtherNetIP 

e ModbusSL 

e ModbusTCP 

e avendor-specific field. 


The vendor-specific field shall begin with the Vendor ID of the company making the addition 
followed by an underscore (VendorID_VendorSpecificField). The VendorID shall be displayed 
in decimal and shall not contain leading zeroes. Each vendor is responsible for maintaining 
and documenting their vendor-specific field. 
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7-3.6.5 Parameters Section 


The parameters section begins with the keyword [Params] and identifies all of the configuration 
parameters in a device. All configuration performed on a device depends on the configuration 
parameters. 


The CIP Parameter Object definition provides more specific details about the parameter fields, 
including the allowed data types and lengths. In general, the EDS parameter fields follow the 
definitions of the CIP Parameter Object instance attributes, except as noted below. 


The parameter section shall identify the configuration parameters in a device. The entry 
keyword shall be one of the following character arrays, “Param”, “ProxyParam”, 
“ProxiedParam”, combined with the Parameter object instance number (decimal) for the 
device, e.g. “Param1”. When a parameter object instance exists within a node, and if this 
parameter is also described within an EDS, then the value of “N” in “ParamN” shall be equal 
to the parameter object instance. The actual parameter object instance may, but need not be, 
implemented in the device. Conversely, it is not required that ALL parameter object instances 
have a corresponding “ParamN” entry in an EDS. Commas shall separate all fields, and a 
semicolon shall indicate the end of an entry. Each entry contains the formatted fields shown in 
the table below. The “ProxyParam”and “ProxiedParam” keywords are defined further in 
Chapter 7-3.7, Modular EDS File Requirements. 


Table 7-3.22 Fields in the Parameters Section 


Field Name Required/Optional 
Link Path Size Required 
Link Path Required 
Descriptor Required 
Data Size | 6s fusinr Required 
Parameter Name Required 
Units String | == 8 =~ ASCII Character Array _ | Required 
Help String | == 9 | ASC Character Array _ | Required 
Minimum Value Conditional ' 
Maximum Value Conditional ! 
Default Value Required 
Scaling Multiplier UINT Optional 
Scaling Divider UINT Optional 
Scaling Base UINT Optional 
Scaling Offset DINT’ Optional 
Multiplier Link UINT Optional 
Divisor Link UINT Optional 
Base Link UINT Optional 
Offset Link UINT Optional 
Decimal Precision USINT Optional 
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Field Name Required/Optional 
International Parameter Name Optional 
International Engineering Units Optional 
International Help String Optional 


1 See Maximum/Minimum Attribute Semantics in the Parameter Object definition in Volume 1, Chapter 5 
for further information. 


2 The data type for this field deviates from the Parameter Object, which is specified as an INT. If the 
ParamN entry is referencing a parameter that exists in a Parameter Object within a device, this value will 
need to be kept in the INT range. 


The following ParmN fields, which require additional definition (beyond the corresponding 
Parameter Object instance attribute definition), are listed below. 


e Reserved - This first field shall contain a zero. 

e Link Path - The link path identifier. The path shall be entered as a character array, using 
the path notation described in Section 7-3.5.8. If the Not Addressable descriptor bit value 
is 1 or the Link Path is empty, the attribute described by this ParamN is not directly 
addressable from the network. If the Not Addressable descriptor bit value is 0 and this field 
is a null string, “”, it shall be addressable as the data attribute (instance attribute 1) of the 
Nth instance of the Parameter object. 

e Parameter Name - The textual parameter name. This field may be longer than the limit 
specified in the Parameter Object. A tool may truncate this text to the limit specified in the 
Parameter Object. 

e Units String - The textual display units character array. This field may be longer than the 
limit specified in the Parameter Object. A tool may truncate this text to the limit specified 
in the Parameter Object. 

e Help String - The textual help character array. This field may be longer than the limit 
specified in the Parameter Object. A tool may truncate this text to the limit specified in the 
Parameter Object. 


The “Enum” keyword shall be used to provide an enumeration list of parameter choices to 
present to the user. The entry keyword for all enumerated parameters shall consist of the 
character array, “Enum”, combined with the decimal number from the corresponding Param 
entry. Commas shall separate all fields, and a semicolon shall indicate the end of the entry. 
Each Enum entry shall consist of pairs of integers and strings. 


Figure 7-3.10 Sample Electronic Data Sheet Illustrating the Parameters Section 
[File] 
[Device] 
[ParamClass] 
[Params] 
Parami = 0, 1,"20 02", 0x0014, OxD2, 2, "Preset", "Vv", 
"User Manual p33", 0, 5, 1, 1, 1, 1, 9, 0, 0, 0, 0, 2; 


Param2 = $ parameter instance 

0, $ First field shall equal 0 
6, "20 04 24 01 30 63", $ path size, path 

0x0014, $ descriptor - in hex format 
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OxD2, $ data type: 16-bit WORD 
2, $ data size 
"Trigger", $ name 
"HZ", $ units 
"User Manual p49", $ help string 
0, 2, 0, $ min, max, default data values 
Aig: A Den 10%, $ mult, div, base, offset scaling 
ror noe $ mult, div, base, offset links not used 
2} $ decimal places 
Param3 = $ not addressable from link 


©, , , ©x0082, OxC6, 1, "Speed control", "", "", 3, 12, 3, yyrrrrer} 


Enum3 = 3, "stop", 8, "Slow", 12, "fast"; 
[Groups] 


7-3.6.6 Parameter Groups Section 


The parameter groups section begins with the keyword [Groups] and identifies all of the 
parameter groups in a device. Each parameter group contains a list of the parameter object 
instances in the group. The entry keyword for each group consists of the combination of the 
character array, “Group”, and the Parameter Group instance number (decimal) in the device, 
for example “Group1”. The decimal numbers must start at one and increment by one. 


The fields in each entry contain the group name, the number of members in the group, and the 
instance numbers of the parameter objects in the group or VariantN/VariantExaN where N is 
the variant number in this EDS or ProxyN where N is the ProxyParam number in this EDS. A 
comma separates all fields, and a semicolon indicates the end of the entry. The parameter 
group section contains: 


Table 7-3.23 Fields in the Parameter Groups Section 


Field Name Field Number Required/Optional 
Group Name String ASCII Character Array Required 
Number of Members UINT Required 


Parameter, Proxy Parameter | 3 thru (number of | UINT for Param, ProxyN for Proxy Required 
or Variant members + 2) | Param or VariantN/VariantExaN for 


Variant 


Figure 7-3.11 Sample Electronic Data Sheet Illustrating the Parameter Groups Section 


$ 
[File] 


[Device] 
[ParamClass] 
[Params] 
[Groups] 
Groupi = "Setup", 3, 1, Variant2, Proxy1; $ group 1 named Setup consists 
$ of Parami, Variant2 & ProxyParam1 
Group2 = "Monitor", 3, 2, 3, Proxy4; $ group 2 named Monitor consists of 
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$ Param2, Param3 and ProxyParam4 


Group3 = "Maintenance", 2, 1, 3; $ group 3 named Maintenance 
$ consists of Param1 and Param3 


7-3.6.7 Assembly Section 


The Assembly section begins with the keyword [Assembly] and describes the structure of a 
data block. Often this block is the data attribute of an Assembly object; however, this section 
of the EDS can be used to describe any complex structure. The description of this data block 
parallels the mechanism that the Assembly object uses to describe its member list. 


7-3.6.7.1 Revision Entry Keyword 


The "Revision" entry keyword shall have one 16-bit integer field that shall be the revision 
(class attribute 1) of the Assembly object within the device. If this optional entry is missing, 
the revision of the Assembly object shall be 2. 


7-3.6.7.2 Assem type Entry Keywords 


The following character arrays are the roots for Assem type entry Keywords: 


e Assem 

e AssemExa 

e ProxyAssem 

e ProxyAssemExa 

e ProxiedAssem 

e ProxiedAssemExa 


The Assem type entry keyword shall consist of a root from the list above combined with the 
Assembly object instance number (decimal) for the device, e.g. “Assem1”. The same instance 
number (decimal) shall not be used for an “AssemN” and an “AssemExaN” entry. The same 
instance number (decimal) shall not be used for a “ProxyAssemN” and a “ProxyAssemExaN” 
entry. The same instance number (decimal) shall not be used for a “ProxiedAssemN” and a 
“ProxiedAssemExaN” entry. If a particular instance of the Assembly object is addressable 
from the link, there shall be a one-for-one pairing between the Assem number in the EDS file 
and the Assembly instance number in the device. Commas shall separate all fields, and a 
semicolon shall indicate the end of the entry. A white space or nothing between commas shall 
be used for optional fields not provided. The “ProxyAssemN”, “ProxyAssemExaN”, 
“ProxiedAssemN”, and “ProxiedAssemExaN” keywords are defined further in Chapter 7-3.7, 
Modular EDS File Requirements. 


“AssemExaN” is an extension of the “AssemN” keyword. “ProxyAssemExaN” is an 
extension of the “ProxyAssemN” keyword. “ProxiedAssemExaN” is an extension of the 
“ProxiedAssemN” keyword. Each “AssemN”, “ProxyAssemN” and “ProxiedAssemN” entry 
shall contain the formatted fields shown in Table 7-3.24. Each “AssemExaN”, 
“ProxyAssemExaN” and “ProxiedAssemExaN” entry shall contain the formatted fields 
shown in Table 7-3.25. 
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7-3.6.7.2.1 


7-3.6.7.2.2 


7-3.6.7.2.3 


Table 7-3.24 AssemN Keyword Format 


Field Name Field Number Data Type Required/Optional 
Name 1 Eds_Char_Array Optional 


Descriptor Optional 
Reserved Optional 
Member Size iG Conditional 


Member tee Empty, AssemN, ParamN, Number or | Conditional 
Reference EPATH 


Field name Required/ Optional 
Name Optional 
Path Optional 
Size Optional 
Descriptor Optional 
Reserved Optional 
Member Size Conditional 
Member ie AssemN, AssemExaN, ParamN, Conditional 


Reference Number, VariantN, VariantExaN or 
EPATH 


Name, Field 1 


The first field, called "Name", shall be a string giving a name to the data block. This optional 
field may be used by a user interface. 


Path, Field 2 


The second field, called "Path", shall be a string that specifies a logical path. This path shall 
identify the address of the data block within the device. If the Not Addressable descriptor bit 
value is 1 or this field is empty, the block described by this AssemN entry is not directly 
addressable from the link. If the Not Addressable descriptor bit value is 0 and this field is a 
null string, “”, the data block shall be addressable as the data attribute (instance attribute 3) of 
the Nth instance of the Assembly object. 


Size, Field 3 


The third field, called "Size", shall be the size of the data block in bytes. When the “Size” field 
is specified as a ParamN, the type of the ParamN shall be UINT or USINT. When the “Member 
Size”/’”Member Reference” fields are present and the “Size” field is present, if the “Size” field 
is smaller than the defined size of the corresponding “Member Size”/”Member Reference” 
fields, the least significant bits of the corresponding “Member Reference” fields shall be used. 
When the “Member Size”/”Member Reference” fields are present and the “Size” field is 
present, if the “Size” field is larger than the defined size of the corresponding “Member 
Size”/’Member Reference” fields, the entire “Member Reference” fields shall be followed by 
zero pads to extend the assembly to the “Size”. 


— 7-49 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 7: Electronic Data Sheets 


When the “Member Size”/”Member Reference” fields are present and the “Size” field is not 
present, the defined size of the corresponding “Member Size”/” Member Reference” fields shall 
be used. 


When the “Member Size”/”Member Reference” fields are not present and the “Size” field is not 
present, the size shall be 0. 


7-3.6.7.2.4 Descriptor, Field 4 


The fourth field, “Descriptor”, shall be a bit-field that describes certain properties of the 
Assembly. The bits of this field are described in Table 7-3.26. If this field is empty it shall be 
interpreted as 0. 


Table 7-3.26 Descriptor Field Bit Value 


Bit Name Meaning 


0 Allow Value 0 The contents of value member references may not be edited. The member 
Edit references considered to be values are a Number, an empty field and a string 
representing an EPATH. 


1 The contents of value member references may be edited. The member 
references considered to be values are a Number, an empty field and a string 
representing an EPATH. 


1-3 Assem Type 0 Not modular Assem 


1 This Assem defines a fixed slot size, expanded adapter rack Assem, the adapter 
device is not included in the Assem. 


This Assem applies to each slot in the rack, in slot order. This Assem shall 
specify a UINT size field, this UINT size shall be the amount of data supplied, 
in bytes, for each slot in the rack. Each module participating in the adapter rack 
Assem shall supply the same amount of data. For empty slots and slots 
containing modules not participating in this adapter rack Assem the pad data 
shall be included, the size of the pad data shall be specified by the UINT size 
field. The member list size may be less than or equal to the size field value. If 
the member list size is less than the size field value the Assem shall be padded 
to the size field value. 


2 This Assem defines a fixed slot size, compressed adapter rack Assem, the 
adapter is not included in the Assem. 


This Assem applies to each slot in the rack, in slot order, that is participating in 
this adapter rack Assem. This Assem shall specify a UINT size field, this UINT 
size shall be the amount of data supplied, in bytes, for each slot in the rack 
participating in the adapter rack Assem. The member list size may be less than 
or equal to the size field value. If the member list size is less than the size field 
value the Assem shall be padded to the size field value. 


3 This Assem defines a variable sized, compressed adapter rack Assem, the 
adapter is not included in the Assem. 


This Assem applies to each slot in the rack, in slot order, that is participating in 
this adapter rack Assem. This Assem may specify a ProxyParamN size field 
which allows each module EDS to define the amount of data included in this 
adapter rack Assem. 


4 Reserved. 
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5 This Assem defines a fixed slot size, expanded adapter rack Assem, the adapter 
device is included in the Assem. 


This Assem applies to each slot in the rack, in slot order. This Assem shall 
specify a UINT size field, this UINT size shall be the amount of data supplied, 
in bytes, for each slot in the rack. Each module participating in the adapter rack 
Assem shall supply the same amount of data. For empty slots and slots 
containing modules not participating in this adapter rack Assem the pad data 
shall be included, the size of the pad data shall be specified by the UINT size 
field. The member list size may be less than or equal to the size field value. If 
the member list size is less than the size field value the Assem shall be padded 
to the size field value. 


6 This Assem defines a fixed slot size, compressed adapter rack Assem, the 
adapter is included in the Assem. 


This Assem applies to each slot in the rack, in slot order, that is participating in 
this adapter rack Assem. This Assem shall specify a UINT size field, this UINT 
size shall be the amount of data supplied, in bytes, for each slot in the rack 
participating in the adapter rack Assem. The member list size may be less than 
or equal to the size field value. If the member list size is less than the size field 
value the Assem shall be padded to the size field value. 


7 This Assem defines a variable sized, compressed adapter rack Assem, the 
adapter is included in the Assem. 


This Assem applies to each slot in the rack, in slot order, that is participating in 
this adapter rack Assem. This Assem may specify a ProxyParamN size field 
which allows each module EDS to define the amount of data included in this 
adapter rack Assem. 


4 Not 0 If the Path field is not empty, the block described by this assembly entry is 
Addressable directly addressable from the link via the Set_Attribute and Get_Attribute 
services. 


1 The block described by this assembly entry is not directly addressable from the 
link via the Set_Attibute or Get_Attribute services. 


5-7 NULL 0 If a member reference is a Parameter whose Indirect Parameter Reference bit is 
Indirect set and whose referenced parameter value is 0 (NULL), then the member size 
Parameter and member reference pair is ignored. 

Handling 1 If a member reference is a Parameter whose Indirect Parameter Reference bit is 


set and whose referenced parameter value is 0 (NULL), then the member size 
and member reference pair and any following member size and member 
reference pairs are ignored. 


2 If a member reference is a Parameter whose Indirect Parameter Reference bit is 
set and whose reference parameter value is 0 (NULL), then the number of bits 
specified by the member size field shall be used as a pad within the Assembly 
object. 

3-7 | Reserved 


8-15 Reserved 0 


See 7-3.6.7.4 Examples of Adapter/Rack Assem Data Formatting for examples. 


7-3.6.7.2.5 Reserved Field 5 


Field 5 shall be reserved for future definition and shall be empty. 


7-3.6.7.2.6 Reserved Field 6 


Field 6 shall be reserved for future definition and shall be empty. 
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7-3.6.7.2.7 Member Size/Member Reference Fields 


The remaining fields shall be paired such that a "Member Size" field is paired with a "Member 
Reference" field making the total number of fields even. Zero remaining fields is valid, which 
represents an empty assembly. The pairs shall correspond to an Assembly object member list. 


The allowed entries for the "Member Reference" field shall be one of the following: 


e aParamN entry from the [Params] section; 

e an AssemN entry from the [Assembly] section; 

e an AssemExaN entry from the [Assembly] section; 
e a VariantN entry from the [Assembly] section; 

e a VariantExaN entry from the [Assembly] section; 
e astring representing a path (EPATH); 

e anumber, maximum value 2°’-1; 

e anempty field; 


If the "Member Reference" field is empty, the number of bits specified by the "Member Size" 
field shall be used as a pad within the Assembly object. A "Member Reference" field 
containing a null string shall be treated as if the field was empty. A "Member Reference" field 
and its corresponding "Member Size" shall not both be empty. The member reference 
specifying an EPATH shall consist of either Logical or Data Segments. 


The "Member Size" field shall have units of bits. If a "Member Size" field is empty, the 
defined size of the corresponding "Member Reference" field shall be used. The defined size of 
a Param entry shall be as given in its 6" field (size). The defined size of an Assem entry shall 
be as given in its 3“ field (size). 


The members shall be placed into the data block least significant bit first just as they are in the 
Assembly object. If a "Member Size" field is smaller than the defined size of the 
corresponding "Member Reference" field, the least significant bits of the corresponding 
"Member Reference" field shall be used. If a "Member Size" field is larger than the defined 
size of the corresponding "Member Reference" field, the entire member shall be followed by 
zero pads to extend the member to the "Member Size". The data block represented shall be an 
integer number of bytes. For example, Assem5 in Figure 7-3.12 shall be 1 byte long and have 
a default value of 0x21. 


Figure 7-3.12 [Assembly] Section Example 


[Params] 
Parami = 
0, $ first field shall equal 0 
6, "20 OF 24 01 30 01", $ path size, path 
0x0000, $ descriptor 
OxD2, $ data type : 16-bit WORD 
2, $ data size in bytes 
"Idle state", $ name 
ars $ units 
"User Manual p48", $ help string 
0, 2, 1, $ min, max, default data values 
0, 0, 9, 0, $ mult, dev, base, offset scaling not used 
0, 0, 9, O, $ mult, dev, base, offset link not used 
0; $ decimal places not used 
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Param2 = 0, 6, "20 OF 24 02 30 01", $ path size, path 
©x0000, OxD2, 2, "Fault state", "", "User Manual p49", 
0, 2, 2, 0, 0, 0, 0, 0, 0, 9, 9, 9; 


[Assembly ] 
Revision 


2; 


Assem5 = "configuration", "20 04 24 05 30 03",1,,,, 


4, Parami, 
3, Param2, 
1, ; 


7-3.6.7.2.8 Specifying Bit Fields 


The ParamN:b syntax is used to specify which bits from a parameter are to be included in an 
assembly. The ‘:b’ indicates the bit offset into the parameter, where ‘0’ refers to bit 0. The 
member reference size indicates the number of relevant bits. It is invalid to specify a size and 
bit offset that ‘overflow’ the parameter. For example, the assembly member reference ”16, 
Param1:2” is not valid when the parameter is 16 bits in size. The bits used from the parameter 
start at the offset specified and continue with the more significant bits for the size specified. 
This syntax allows disjoint bits within an assembly to be represented with a single parameter. 


Figure 7-3.13 ParamN:b Syntax Example 


[Params] 
Parami = 0, $ first field shall equal 0 
iy $ path size, path 
0x0002, $ descriptor 
OxC6, $ data type: Unsigned short integer 
al $ data size in bytes 
"Channel © Range Selection Bits", $ name 
eee $ units 
ae $ help string 
0,3,0, $ min, max, default data values 
0,0,0,90, $ mult, dev, base, offset scaling not used 
0,0,0,90, $ mult, dev, base, offset link not used 
0; $ decimal places 
Enumi = 0, “Off”, 1, “4-20mA”, 2, “O-10V", 3, “-10 to +10V” 


$ Param2, Param3 & Param4 are similar for Channel 2, Channel 3 & Channel 4 


[Assembly ] 
Assem1 = “Configuration Data”, "20 7D 24 00 30 OC",,,,, 


1,Param1:0, $ Channel © full range bit 
1,Param2:0, $ Channel 1 full range bit 
1,Param3:0, $ Channel 2 full range bit 
1,Param4:0, $ Channel 3 full range bit 
4,, $ Not used - must be © [fill bits] 
1,Parami:1, $ Channel © selection bit 
1,Param2:1, $ Channel 1 selection bit 
1,Param3:1, $ Channel 2 selection bit 
1,Param4:1, $ Channel 3 selection bit 
45, $ Not used - must be 0 
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7-3.6.7.3 Variant and VariantExa Entry Keywords 


The “Variant” and “VariantExa” keywords shall be used to describe a dependent member of 
an assembled data buffer. The “Variant” and “VariantExa” keywords are similar to a 
‘Switch’ statement in a high-level programming language. The ‘Switch’ statement is a multi- 
way decision that tests whether an expression matches one of a number of constant integer 
values, and branches accordingly. The “Variant” or “VariantExa” entry in the [Assembly] 
section serves a similar purpose. It uses specific bits in an assembly or a parameter to obtain a 
value called the ‘Switch selector’ that is used to match a number of constant integer values. 
Once a match is found the corresponding assembly or parameter is used in place of the 
“VariantN” or “VariantExa” entry (see Figure 7-3.14 for an example). If multiple matches 
are found one of the corresponding assemblies or parameters shall be used in place of the 
“VariantN” or “VariantExa” entry. The method for selecting which corresponding assembly 
or parameter requires user intervention. Multiple matches are supported because determination 
of the device configuration is not available by electronic means. 


The entry keyword shall consist of the character array, “Variant” or “VariantExa”, combined 
with a decimal number, e.g. “Variant1” or “VariantExa1”. The same decimal number shall 
not be used for a “VariantN” and a “VariantExaN” entry. Commas shall separate all fields, 
and a semicolon shall indicate the end of the entry. White space or nothing between commas 
shall be used for optional fields not provided. 


“VariantExaN” is an extension of the “VariantN” keyword. Each “VariantN” entry shall 
contain the formatted fields shown in Table 7-3.27. Each “VariantExaN” entry shall contain 
the formatted fields shown in Table 7-3.28. 


Table 7-3.27 Variant Entry Format 


Field name ee Data type Required/Optional 
Name 1 Eds_Char_Array Optional 
Help String 2 ASCII Character Array | Optional 
Reserved 3 Empty Optional 
Reserved 4 Empty Optional 
Reserved 5 Empty Optional 
Switch selector 6 Param or Assem Required 
First Selection value 7 UINT Required 
First Selection entry 8 Param Required 
Second Selection value 9 UINT Required 
Second Selection entry 10 Param Required 
Subsequent Selection values | 11,13... UINT Optional 
Subsequent Selection entries | 12,14,... Param Optional 
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Table 7-3.28 VariantExa Entry Format 


Field name ura Data type Required/Optional 

Name 1 Eds_Char_Array Optional 

Help String 2 ASCII Character Array | Optional 

Reserved 3 Reserved Optional 

Reserved 4 Reserved Optional 

Reserved 5 Reserved Optional 

Switch selector 6 Param, Assem or Required 
AssemExa 

First Selection value 7 UINT Required 

First Selection entry 8 Param, Assem or Required 
AssemExa 

Second Selection value 9 UINT Required 

Second Selection entry 10 Param, Assem or Required 
AssemExa 

Subsequent Selection values | 11,13,... UINT Optional 

Subsequent Selection entries | 12,14,... Param, Assem or Optional 
AssemExa 


7-3.6.7.3.1 Name, Field 1 


The “Name” field shall be a string giving a name to the variant. This optional field may be 
used by the user interface. 


7-3.6.7.3.2 Help String, Field 2 


The “Help String” field shall be a string providing help for the variant. This optional field may 
be used by the user interface. 


7-3.6.7.3.3 Reserved Field 3 


Field 3 shall be reserved for future definition and shall be empty. 


7-3.6.7.3.4 Reserved Field 4 


Field 4 shall be reserved for future definition and shall be empty. 


7-3.6.7.3.5 Reserved Field 5 


Field 5 shall be reserved for future definition and shall be empty. 
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7-3.6.7.3.6 Switch Selector, Field 6 


The “Switch selector” field shall be an AssemN, ProxyAssemN or ProxiedAssemN entry from 
the [Assembly] section or a ParamN, ProxyParamN or ProxiedParamN from the [Params] 
section. A reference to a “symbolic” may use the syntax “symbolic:N1:N2” where N1 
specifies a bit offset into the “symbolic” and N2 specifies the number of bits to use. For 
example, “Assem1:0:4” indicates to use the first four bits of Assem1. The assembly or 
parameter specified as the “Switch selector” shall exist within the device and therefore shall 
have a path specified in its definition within the Assembly or Parameter section. The switch 
selector field shall not specify a portion of an assembly that is a variant. 


7-3.6.7.3.7. Switch Selection Entry/Value Fields 


The remaining fields shall be paired such that a “Selection value” field is paired with a 
“Selection entry” field. The “Selection value” field is an unsigned integer and is used in the 
matching process described below. The “Selection entry” field shall be a ParamN, 
ProxyParamN, or ProxiedParamN entry from the [Params] section or, for a VariantExaN 
keyword entry, an AssemN, AssemExaN, ProxyAssemN, ProxyAssemExaN, ProxiedAssemN 
or ProxiedAssemExaN from the [Assembly] section. The first two “Selection value” / 
“Selection entry” pairs are required to be specified. Subsequent pairs may also be specified. 
There is no numeric ordering of the pairs required. Only the matched selection entry specified 
in a VariantN or VariantExaN shall be visible through the variant, other selection entry(s) in 
the VariantN or VariantExaN shall be not be visible. 


The “Switch selector” field is used to determine a specific “Selection value”. The “Switch 
selector” value is compared with each of the “Selection value” fields until a match is found. 
The “Selection entry” paired with the matched “Selection value” is then used as the entry 
(parameter or assembly) in the assembly. If a match is not found the user interface shall display 
an error. 


Figure 7-3.14 Variant Keyword Example 


[Params] 
Parami = 
0, $ first field shall equal 0 
hy $ path size, path 
0x0002, $ descriptor 
OxC6 $ data type : Unsigned short integer 
iL, $ data size in bytes 
"Output Channel © Configuration", $ name 
ae $ units 
uae $ help string 
0,2,0, $ min, max, default data values 
0,0,0,0, $ mult, dev, base, offset scaling not used 
0,0,0,90, $ mult, dev, base, offset link not used 
0; $ decimal places not used 
Enumi = 0, “Channel not configured”, 1, “4-20mA”, 2, “+-10V"; 
Param2 = 
0, $ first field shall equal 0 
Po $ path size, path 
0x0044, $ descriptor (scaling and decimal precision) 
OxC7, $ data type : 16 bit unsigned integer 
2, $ data size in bytes 
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“Output Channel 0 4-20mA ", $ name 

"mA", $ units 

ee $ help string 

0, 30840,0, $ min, max, default data values 

1,1927,100, 7712, $ mult, dev, base, offset 

0,0,0,90, $ mult, dev, base, offset link not used 

2; $ decimal places 

Param3 = 

0, $ first field shall equal 0 

her $ path size, path 

0x0044, $ descriptor (scaling and decimal precision) 

OxC7, $ data type : 16 bit unsigned integer 

2, $ data size in bytes 

"Output Channel © +-10V ", $ name 

ia $ units 

Be $ help string 

31969, 33567, 31969, $ min, max, default data values 

1,79,100, -32769, $ mult, dev, base, offset 

0,0,0,90, $ mult, dev, base, offset link not used 

23 $ decimal places 

Param4 = 

0, $ first field shall equal 0 

i $ path size, path 

0x0044, $ descriptor (scaling and decimal precision) 

OxC7, $ data type : 16 bit unsigned integer 

2, $ data size in bytes 

"Output Channel © 0-20mA ", $ name 

"mA", $ units 

me $ help string 

0, 31208,0, $ min, max, default data values 

1,1560,1000,0, $ mult, dev, base, offset 

0,0,0,90, $ mult, dev, base, offset link not used 

23 $ decimal places 

[Assembly ] 

Assem1 = 

“configuration”,”20 7D 24 00 30 OC”, ,,,, 

4,Parami; $ Output Channel 0 Configuration 

Varianti = “Output Channel © Configuration”, $ name 

Py $ Reserved fields 

Assem1:0:4, $ value of Param1 in Assem1 is used to select 
$ one of the following parameters 

©x01, Param2, $ if the above value is 0x01 then use Param2 

0x02, Param3, $ the user needs to indicate which parameter 
$ to user (Param3 or Param4) when the above 
$ value is 2 

@x02, Param4; $ the user needs to indicate which parameter 
$ to user (Param3 or Param4) when the above 
$ value is 2 

Assem2 = 

“output” yrvcvever 

4, Variant1; 
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7-3.6.7.4 Examples of Adapter/Rack Assem Data Formatting 


The following examples illustrate the concepts of Adapter/Rack Assembly data formatting 
sections of the EDS file. 


7-3.6.7.4.1 Example 1 


Example of a fixed slot size (2 bytes per slot), expanded adapter rack Assem, adapter excluded 
(Assem type = 1). The table below illustrates an example rack with an adapter in a 9-slot rack. 


Table 7-3.29 Rack Module Descriptions for Example 1 


Slot 0 Slot 1 Slot 2 Slot 3 Slot 4 Slot 5 Slot 6 Slot 7 Slot 8 
Adapter 16-bit 16-bit Empty 16-bit 16-bit 16-bit 16-bit 16-bit 


input input slot output | input and | input and | output input 
module module module output output module | module 
module module 


The input data buffer being described by ProxyAssem1 and ProxiedAssem1 below is: 


Table 7-3.30 Slot Data Descriptions for Example 1 


Slot 1 16 bits of data, format unspecified 

Slot 2 4 bits of data described by Param1, 12 bits described by Param2 
Slot 3 16 bits of pad 

Slot 4 16 bits of pad 

Slot 5 4 bits of data described by Param1, 12 bits described by Param2 
Slot 6 4 bits of data described by Param1, 12 bits described by Param2 
Slot 7 16 bits of pad 

Slot 8 4 bits of data described by Param1, 12 bits described by Param2 


The following adapter and module EDS snippets could be used to describe the adapter rack 
input Assem for the example rack: 


Figure 7-3.15 EDS File Entries (partial) for Example 1 


Adapter EDS: 
ProxyAssem1 = 
“Module Input Data”, $ Assem name 
“20 04 24 SLOT 30 0A”, $ no path 
2, $ 2 bytes of input per slot 
0b0000000000000010, $ fixed slot size, expanded adapter rack 
$ Assem, adapter excluded 
ror $ reserved, reserved 
ModuleMemberList; $ the module EDS specifies the format of 
$ the module input data 
Module in slot 1 EDS: 
ProxiedAssem1 = ,,,,,, $ Assem name, path, size, descriptor, 
$ reserved, reserved 
16,; $ 16 bits of input data, format unspecified 
Module in slot 2 EDS: 
ProxiedAssem1 = ,,,,,, $ Assem name, path, size, descriptor, 
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$ reserved, reserved 
4, Param1, $ 4 bits of input data 
12, Param2; $ 12 bits of input data 
Module in slot 4 EDS: 
ProxiedAssem1 = ,,,,,, $ Assem name, path, size, descriptor, 
$ reserved, reserved 
F $ no input data 
Module in slot 5 EDS: 
ProxiedAssemi = ,,,,,, $ Assem name, path, size, descriptor, 
$ reserved, reserved 
4, Param1, $ 4 bits of input data 
12, Param2; $ 12 bits of input data 
Module in slot 6 EDS: 
ProxiedAssem1 = ,,,,,, $ Assem name, path, size, descriptor, 
$ reserved, reserved 
4, Param1, $ 4 bits of input data 
12, Param2; $ 12 bits of input data 
Module in slot 7 EDS: 
ProxiedAssem1 = ,,,,,, $ Assem name, path, size, descriptor, 
$ reserved, reserved 
i $ no input data 
Module in slot 8 EDS: 
ProxiedAssem1 = ,,,,,, $ Assem name, path, size, descriptor, 
$ reserved, reserved 
4, Param1, $ 4 bits of input data 
12, Param2; $ 12 bits of input data 


7-3.6.7.4.2 Example 2 


Example of a fixed slot size (2 bytes per slot), compressed adapter rack Assem, adapter 
excluded (Assem type = 2). The table below illustrates an example rack with an adapter in a 9- 
slot rack. 


Table 7-3.31 Rack Module Descriptions for Example 2 


Slot 0 Slot 1 Slot 2 Slot 3 Slot 4 Slot 5 Slot 6 Slot 7 Slot 8 
Adapter 16-bit 16-bit Empty 16-bit 16-bit 16-bit 16-bit 16-bit 


input input slot output | input and | input and | output input 
module module module output output module | module 
module module 


The input data buffer being described by ProxyAssem1 and ProxiedAssem1 below is: 


Table 7-3.32 Slot Data Descriptions for Example 2 


Slot 1 16 bits of data, format unspecified 
Slot 2 4 bits of data described by Param1, 12 bits described by Param2 
Slot 5 4 bits of data described by Param1, 12 bits described by Param2 
Slot 6 4 bits of data described by Param1, 12 bits described by Param2 
Slot 8 4 bits of data described by Param1, 12 bits described by Param2 
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The following adapter and module EDS snippets could be used to describe the adapter rack 
input Assem for the example rack: 


Figure 7-3.16 EDS File Entries (partial) for Example 2 


Adapter EDS: 
ProxyAssem1 = 
“Module Input Data”, $ Assem name 
“20 04 24 SLOT 30 0A”, $ no path 
2, $ 2 bytes of input per slot 
0b0000000000000100, $ fixed slot size, compressed adapter 
$ rack Assem, adapter excluded 
fan $ reserved, reserved 
ModuleMemberList; $ the module EDS specifies the format of 
$ the module input data 
Module in slot 1 EDS: 
ProxiedAssemi = ,,,,,, $ Assem name, path, size, descriptor, 
$ reserved, reserved 
16,; $ 16 bits of input data, format unspecified 
Module in slot 2 EDS: 
ProxiedAssem1 = ,,,,,, $ Assem name, path, size, descriptor, 
$ reserved, reserved 
4, Parami, $ 4 bits of input data 
12, Param2; $ 12 bits of input data 
Module in slot 5 EDS: 
ProxiedAssemi = ,,,,,, $ Assem name, path, size, descriptor, 
$ reserved, reserved 
4, Param1, $ 4 bits of input data 
12, Param2; $ 12 bits of input data 
Module in slot 6 EDS: 
ProxiedAssem1 = ,,,,,, $ Assem name, path, size, descriptor, 
$ reserved, reserved 
4, Param, $ 4 bits of input data 
12, Param2; $ 12 bits of input data 
Module in slot 8 EDS: 
ProxiedAssem1 = ,,,,,, $ Assem name, path, size, descriptor, 
$ reserved, reserved 
4, Param, $ 4 bits of input data 
12, Param2; $ 12 bits of input data 
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7-3.6.7.4.3 Example 3 


Example of a variable sized, compressed adapter rack Assem, adapter excluded (Assem type = 
3). The table below illustrates an example adapter rack with an adapter in a 9-slot rack. 


Table 7-3.33 Rack Module Descriptions for Example 3 


Slot 0 Slot 1 Slot 2 Slot 3 Slot 4 Slot 5 Slot 6 Slot 7 Slot 8 
Adapter 16-byte 16-byte | Empty 8-byte 16-byte 16-byte 8-byte 2-byte 


input input slot output | input and | input and | output input 
module module module 4-byte 4 byte module | module 
output output 
module module 


The input data buffer described by ProxyAssem1 and the ProxiedAssem1’s is: 


Table 7-3.34 Slot Data Descriptions for Example 3 


Slot 1 128 bits of data, format unspecified 
Slot 2 A bits of data described by Param1, 12 bits described by Param2 
Slot 5 128 bits of data, format unspecified 
Slot 6 128 bits of data, format unspecified 
Slot 8 4 bits of data described by Param1, 12 bits described by Param2 


The following adapter and module EDS snippets could be used to describe the adapter rack 
input Assem for the example rack: 
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Figure 7-3.17 EDS File Entries (partial) for Example 3 


Adapter EDS: 
ProxyAssem1 = 


“Module Input Data”, $ Assem name 

“20 04 24 SLOT 30 0A”, $ no path 

' $ size not specified, use member list size 

0b0000000000000110, $ variable sized, compressed adapter rack 
$ Assem, adapter excluded 

rr $ reserved, reserved 

ModuleMemberList; $ the module EDS specifies the format of 
$ 


the module input data 


Module in slot 1 EDS: 


ProxiedAssemi = ,,,,,, $ Assem name, path, size, descriptor, 
$ reserved, reserved 
128,; $ 128 bits of input data, format unspecified 


Module in slot 2 EDS: 


ProxiedAssem1 = ,,,,,, $ Assem name, path, size, descriptor, 
$ reserved, reserved 
4, Param1, $ 4 bits of input data 
12, Param2; $ 12 bits of input data 
Module in slot 5 EDS: 
ProxiedAssem1 = ,,,,,, $ Assem name, path, size, descriptor, 
$ reserved, reserved 
128; $ 128 bits of input data, format unspecified 
Module in slot 6 EDS: 
ProxiedAssem1 = ,,,,,, $ Assem name, path, size, descriptor, 
$ reserved, reserved 
128; $ 128 bits of input data, format unspecified 
Module in slot 8 EDS: 
ProxiedAssem1 = ,,,,,, $ Assem name, path, size, descriptor, 
$ reserved, reserved 
4, Param1, $ 4 bits of input data 
12, Param2; $ 12 bits of input data 
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7-3.6.8 Complete Electronic Data Sheet Example 


An Electronic Data Sheet example is given below which is a compilation of the section 
examples given thus far in this chapter. 


Figure 7-3.18 Electronic Data Sheet Example 


[File] 
DescText = "Smart Widget EDS File"; 
CreateDate = 04-03-1994; $ created 
CreateTime = 17:51:44; 
ModDate = 04-06-1994; $ last changed 
ModTime = 22:07:30; 
Revision = 2.1; $ revision of EDS 
[Device] 
VendCode = 65535; 
VendName = "Widget-Works, Inc."; 


ProdType = @; 

ProdTypeStr = "Generic"; 
ProdCode = 42; 

MajRev = 1; 

MinRev = 1; 

ProdName = "Smart-Widget"; 
Catalog = "1499-DVG"; 


[ParamClass] 
MaxInst = 3; 
Descriptor = Ox0E; 

CfgAssembly = 3; 


[Params] 
Parami = 0, 1,"20 02", 0x0014, OxC6, 1,"Preset","V","User Manual p33", 
0, 5, 1, 1, 1, 1, 0, 0, 0, 0, 0, 2; 
Param2 = $ parameter instance 
0, $ First field shall equal 0 
1, "20 04", $ path size, path 
0x0014, $ descriptor - in hex format 
©xC6, $ data type: Unsigned 8-Bit Integer (USINT) 
1, $ data size 
“Trigger”, $ name 
“HZ”, $ units 
“User Manual p49”, $ help string 
0, 2, 0, $ min, max, default data values 
de hy. 1407 $ mult, div, base, offset scaling 
0, 0, O, 0, $ mult, div, base, offset links not used 
2 $ decimal places 
[Groups] 
Groupi = "Setup", 2, 1, 2; $ group 1 
Group2 = "Monitor", 2, 2, 3; $ group 2 


Group3 = "Maintenance", 2, 1, 3; $ group 3 
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7-3.6.9 Connection Manager Section 


The Connection Manager section defines the set of target I/O connections supported by this 
device. These target I/O connections may exist as static connections predefined in the device or 
they may be dynamic I/O target connections which need to be configured in the device. 
Devices that support the Connection Configuration object may support the ability to 
dynamically create target I/O connections. 


The Connection Manager section begins with the keyword [Connection Manager] and shall 
contain information concerning the number of types of application connections a device 
supports. Each entry keyword shall be one of the following character arrays, “Connection”, 
“ProxyConnect”, “ProxiedConnect”, combined with a number (decimal), for example, 
“Connection1”, “ProxyConnect1”, or “ProxiedConnect1”. The decimal numbers shall start 
at 1 and increment for each additional “Connection” entry. The decimal number shall not be 
required to start at 1 or increment for each additional “ProxyConnect” or “ProxiedConnect” 
entry. Commas shall separate all fields, and a semicolon shall indicate the end of the entry. A 
white space or nothing between commas shall be used for optional fields not provided. The 
“ProxyConnect” and “ProxiedConnect” keywords are defined further in Chapter 7-3.7, Modular 
EDS File Requirements. 


Each entry shall contain the formatted fields shown in Table 7-3.35. 


Table 7-3.35 Fields in the Connection Manager Section 


Field name Field number Data type Required/Optional 
Trigger and transport 1 DWORD Required 
Connection parameters 2 DWORD Required 
O->T RPI 3 UDINT or Param Optional 
O->T size 4 UINT or Param Conditional 
O->T format 5 Param or Assem or Conditional 
AssemExa 
T->O RPI 6 UDINT or Param Optional 
T->O size 7 UINT or Param Conditional 
T->O format Param or Assem or Conditional 
AssemExa 
config #1 size 9 UINT or Param Optional 
config #1 format 10 Param or Assem or Optional 
AssemExa 
config #2 size 11 UINT or Param Optional 
config #2 format 12 Param or Assem or Optional 
AssemExa 
Connection name string 13 Eds_Char_Array Required 
Help string 14 Eds_Char_Array Required 
Path 15 Eds_Char_Array Required 
Safety ASYNC 16 See CIP Safety Spec Conditional * 
Safety Max Consumer Number 17 (Volume 5, Chapter 5) Conditional * 


1 - These fields are not allowed if the connection is not a safety connection. If the connection is a safety 


connection, see Volume 5. 
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7-3.6.9.1 Trigger and transport mask 


The bit assignments for the trigger and transport mask shall be as shown in Table 7-3.36 A bit 
shall be set to a 1 (on) for each trigger mode the connection supports. All other bits shall be set 
to a O (off). For the client/server bit: 0=client, 1=server. Only one of the transport types shall 
be set to a 1 (on). 


Table 7-3.36 Trigger and transport mask bit assignments 


Bit Bit definition 

0 class 0: null 

1 class 1: duplicate detect 

2 class 2: acknowledged 

3 class 3: verified 

4 class 4: non-blocking 

5 class 5: non-blocking, fragmenting 

6 class 6: multicast, fragmenting 

7-15 class: reserved 

16 trigger: cyclic 

17 trigger: change of state 

18 trigger: application 

19-23 trigger: reserved 

24 transport type : listen-only 

25 transport type : input-only 

26 transport type : exclusive-owner 

27 transport type : redundant-owner 

28-30 reserved 

31 client = 0 / server = 1 
7-3.6.9.2 Connection parameters 


The bit assignments for the connection type and priority mask shall be as shown in Table 7- 
3.37. A bit shall be set to a 1 (on) for each connection type and priority the connection 
supports. All other bits shall be set to a 0 (off). 


Table 7-3.37 Connection Parameters Bit Assignments 


Bit Bit definition 
O->T fixed size supported 


O->T variable size supported 


T->O fixed size supported 


WI INI RI]|oO 


T->O variable size supported 
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Bit Bit definition 


4-5 Obsolete, this capability now exists in AssemN descriptor bits 1-3 (Assem 
Type). 
O->T number of bytes per slot in the O->T real time data packet for 
adapter rack connections. 

0 = 1 byte 

1 =2 bytes 

2 = 4 bytes 

3 = 8 bytes 


6-7 Obsolete, this capability now exists in AssemN descriptor bits 1-3 (Assem 

Type). 
T->O number of bytes per slot in the T->O real time data packet for 
adapter rack connections. 

0 = 1 bytes 

1 =2 bytes 

2 = 4 bytes 

3 = 8 bytes 


8-10 |O->T Real time transfer format. 

0 = connection is pure data and is modeless. 

1 = Use zero data length packet to indicate idle mode. 
2 = reserved 

3 = heartbeat 

4 = 32-bit run/idle header 

5 thru 7 are reserved 


11 reserved 


12-14 | T->O Real time transfer format 

0 = connection is pure data and is modeless. 

1 = Use zero data length packet to indicate idle mode 
2 = reserved 

3 = heartbeat. 

4 = 32-bit run/idle header 

5 thru 7 are reserved 


15 reserved 

16 O->T connection type: NULL 

17 O->T connection type: MULTICAST 
18 O->T connection type: POINT2POINT 
19 O->T connection type: reserved 

20 T->O connection type: NULL 

21 T->O connection type: MULTICAST 
22 T->O connection type: POINT2POINT 
23 T->O connection type: reserved 

24 O->T priority: LOW 

25 O->T priority: HIGH 

26 O->T priority: SCHEDULED 

27 O->T priority: reserved 

28 T->O priority: LOW 

29 T->O priority: HIGH 

30 T->O priority: SCHEDULED 

31 T->O priority: reserved 
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7-3.6.9.3 O->T RPI 


The O->T RPI shall be the number of microseconds of the requested packet interval. The O->T 
RPI shall be a UDINT or a Param entry from the [Params] section that evaluates to a UDINT. 
If this field is empty, no constraints are placed on the O->T RPI. 


7-3.6.9.4 O->T size 


The O->T size shall be the number of bytes sent in the O->T packet excluding the conditional 
sequence count (the sequence count does not exist for class 0 connections) and conditional 32- 
bit real time header (the real time transfer format is specified by bits 8-10 of the connection 
parameters field) sizes. The O->T size shall be a UINT or a Param entry that evaluates to a 
UINT. If this field is empty, the defined size of the O->T format shall be used. 


7-3.6.9.5 O->T format 


The O->T format entry shall define the structure of the consumer buffer for this connection. 
Valid format descriptors shall be identifiers within the EDS file including 


e a Param entry from the [Params] section; 
e an Assem/AssemExa entry from the [Assembly] section. 


This field may be empty indicating that the consuming format is not specified. This field shall 
not be empty if the O->T size field is empty. The O->T format shall not include the 32-bit real 
time header if it is present. 


When the O->T format field is not empty and the O->T size field is not empty, if the O->T size 
field is smaller than the defined size of the O->T format, the least significant bytes of the O->T 
format fields shall be used. When the O->T format field is not empty and the O->T size field is 
not empty, if the O->T size field is larger than the defined size of the O->T format, the entire 
O->T format field shall be followed by zero pads to extend the O->T format to the “O->T 
Size”. 


7-3.6.9.6 T->O RPI 


The T->O RPI shall be the number of microseconds of the requested packet interval. The T->O 
RPI shall be a UDINT or a Param entry from the [Params] section that evaluates to a UDINT. 
If this field is empty, no constraints are placed on the T->O RPI. 


7-3.6.9.7 T->O size 


The T->O size shall be the number of bytes sent in the T->O packet excluding conditional 
sequence count (the sequence count does not exist for class 0 connections) and conditional 32- 
bit real time header (the real time transfer format is specified by bits 12-14 of the connection 
parameters field) sizes. The T->O size shall be a UINT or a Param entry that evaluates to a 
UINT. If this field is empty, the defined size of the T->O format shall be used. 
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7-3.6.9.8 T->O format 


The T->O format shall define the structure of the producer buffer for this connection. Valid 
format descriptors shall be identifiers within the EDS file including 


e a Param entry from the [Params] section; 
e an Assem/AssemExa entry from the [Assembly] section. 


This field may be empty indicating that the producing format is not specified. This field shall 
not be empty if the T->O size field is empty. The format shall include the 32-bit real time 
header if it is present. 


When the T->O format field is not empty and the T->O size field is not empty, if the T->O size 
field is smaller than the defined size of the T->O format, the least significant bytes of the T->O 

format fields shall be used. When the T->O format field is not empty and the T->O size field is 

not empty, if the T->O size field is larger than the defined size of the T->O format, the entire T- 
>O format field shall be followed by zero pads to extend the T->O format to the “T->O Size”. 


7-3.6.9.9 Configuration 


The config #1 size and config #2 size shall specify the size of the optional data segment that is 
appended to the path in the Forward_Open. The data segment shall be the concatenation of the 
two buffers described by the config #1 format and config #2 format. The sizes shall be the 
number of bytes and shall be a UINT or a Param entry from the [Params] section that evaluates 
to a UINT. If one of the config size fields is empty, the natural size of the corresponding 
config format field shall be used. 


Valid config format fields shall be identifiers within the EDS file including 


e a Param entry from the [Params] section; 
e an Assem/AssemExa entry from the [Assembly] section. 


The config format fields may be empty indicating that the config format is not specified. If 
both the config size and config format fields are empty, no data segment shall be appended to 
the path of the Forward_Open. 

7-3.6.9.10 Connection Name String 
A tool may display the connection name string (character array). The connection name string 
shall be unique among all Connection entries within the EDS. 


7-3.6.9.11 Help string 


A tool may display the textual help character array. If no help string is to be provided a “null” 
string shall be used where a null string is defined as two double quotations: “” with no 
characters between the quotation marks. 


7-3.6.9.12 Path 


A path referencing the target object. The path shall be entered as a CIP Path (character array). 
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Figure 7-3.19 [Connection Manager] Section Example 


[Params] 
Parami = $ specifies read buffer 
OFe yy $ no path means not directly accessible 
0x0004, $ descriptor : support scaling 
Oxcé, 1, $ USINT, 1 byte 
"Read", $ name 
Ep int $ units & help string 
64, 95, 64, $ min, max, default data values 
1, 1, 1, -63, $ mult, div, base, offset scaling 
0, 0, 0, 0, 0; $$ mult, div, base, offset link & decimal (not used) 
Param2 = specifies write buffer 
0, ,, no path means not directly accessible 
0x0004, descriptor : support scaling 
Oxc6é, 1, USINT, 1 byte 
"Write", name 


y T 
160, 191, 160, 
1.4. A, SA59, 
0, 0, 0, 0, 0; 


units & help string 

min, max, default data values 

mult, div, base, offset scaling 

mult, div, base, offset link & decimal $(not used) 


PRA FH FAH HAHA 


[Connection Manager ] 


Connection1 = 
0x04010002, $ trigger & transport 
$ class 1, cyclic, exclusive-owner 
0x44244401, $ point/multicast & priority & real time format 
$ fixed, 32-bit headers, scheduled, 
$ O->T point-to-point, T->0 multicast 
, 16, , $ O->T RPI, size, format 
, 12, , $ T->0 RPI, size, format 
id $ config part 1 (not used) 
aa $ config part 2 (not used) 
"read/write", $ connection name 


ee $ Help string 
"20 04 24 01 2C [Param2] 2C [Parami]"; 


7-3.6.10 Port Section 


The Port section begins with the keyword [Port] and shall describe the CIP ports available 
within a device. Every CIP shall have a corresponding entry in this section. The entry 
keyword for all ports shall consist of the character array “Port”, combined with a decimal 
number corresponding to an instance of the port object. For example, Port1 is instance 1 of the 
Port Object. A white space or nothing between commas shall be used for optional fields not 
provided. 
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Table 7-3.38 Fields in the Port Section 
Required/Optional 


Field Name Field number Data type i 
Port Type Name $= Keyword Required 


Port Name Conditional' 
Port Object eee Optional 
Port Number Required 
Reserved Not Used 
Port Specific Port Specific 


1 This field is required if the CIP port shares a physical network port with another CIP port. 


The first field, called “Port Type Name”, shall be one of 


e ControlNet 

e ControlNet_Redundant 

e TCP! 

e DeviceNet 

e CompoNet 

e ModbusSL 

e ModbusTCP 

e A vendor-specific value beginning with the device’s Vendor ID and an underscore 
character (‘65535_’). 


Figure 7-3.20 [Port] Section Example 


[Port] 
Porti = DeviceNet, 
“Port A”, 
“20 03 24 01”, 
2; 


name of port 
instance one of the DeviceNet object 
port number 2 


AAA 


Port2 = 65535 Chassis, 

“Chassis”, $ name of port 

“20 9A 24 01", $ vendor specific back-plane object 
ls $ port number 1 


The “Port Name” field shall be a string giving a name to the physical network port, and may be 
used by a user interface. If multiple Port entry keywords contain the same Port Name field 
value, then those CIP ports share the same physical network port. See the Port Name attribute 
(Attribute ID 4) of the Port Object in Chapter 3 for the definition of this field. The “Port 
Object” field shall be a path that identifies the object associated with the port. 


The port number 1 shall correspond to the back plane “port”. Devices with a back plane that 
cannot send CIP messages shall not have a port number 1. 


' This shall indicate an EtherNet/IP capable TCP port 
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7-3.6.11 


7-3.6.11.1 


Capacity Section 


The Capacity section shall contain information relating to a device’s communications capacity. 
Capacity section keywords are primarily oriented towards specifying a device’s I/O 
communications capacity. The Capacity section also contains parameters not specifically 
related to I/O. 


The entries in the Capacity section are intended to allow a software tool to walk through a set 
of configured connections for a system and determine whether each of the devices will be able 
to handle the configured load. 


The following table shows the keywords defined for the Capacity section: 


Table 7-3.39 Capacity Section keywords 


Entry Name Entry Keyword Number of | Data Type | Required/Optional 
Fields 
Traffic Spec TSpecN Optional 
Connection overhead ConnOverhead REAL Optional 


Maximum CIP connections MaxCIPConnections UINT Conditional 
Maximum I/O connections MaxIOConnections UINT Conditional 
Maximum explicit messaging | MaxMsgConnections 1 UINT Conditional 
connections 

Maximum I/O producers MaxIOProducers UINT Conditional 
Maximum I/O consumers MaxIOConsumers UINT Conditional 
Maximum I/O producer plus MaxIOProduceConsume 1 UINT Conditional 
consumers 

Maximum I/O multicast MaxIOMcastProducers 1 UINT Conditional 
producers 

Maximum I/O multicast MaxIOMcastConsumers 1 UINT Conditional 
consumers 

Maximum consumers per MaxConsumersPerMcast 1 UINT Conditional 
multicast connection 


Traffic Spec 


The Traffic Spec keyword shall be used to indicate a device’s maximum implicit 
communications packet rate (packets per second) across the range of supported CIP connection 
sizes. An EDS file will typically have a set of Traffic Spec keywords, TSpec1 through 
TSpecNmax, to describe the device’s maximum implicit packet rate across different connection 
sizes. 


The following table shows the format of the Traffic Spec keyword: 


Table 7-3.40 Traffic Spec Keyword Format 


Field Name Data Type Required/Optional 
ConnSize Required 
PacketsPerSecond Required 
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e = TxRx shall have one of the following values: “Tx”, “Rx”, or “TxRx”. Tx shall indicate 
that the Traffic Spec applies to packets transmitted (produced) by the device. “Rx” shall 
indicate that the Traffic Spec applies to packets received (consumed) by the device. 
“TxRx” shall indicate that the Traffic Spec applies to both packets transmitted and 
received. If any of the Traffic Spec entries in a Capacity section use “TxRx” then ALL 
entries in the section shall use “TxRx”. 

e ConnSize shall be the CIP connection size, in bytes. That is, the ConnSize corresponds to 
the O->T and T->O connection size in the Forward Open service, or to the 
Produced_connection_size and Consumed_connection_size instance attributes of the 
Connection Object. 

e PacketsPerSecond shall be the maximum number of implicit packets per second the 
device can process at the given ConnSize. 


A Traffic Spec is a point on the connection size vs. packets per second curve. Between any 
two adjacent points, the curve is assumed to be linear. Devices can specify as few or as many 
different traffic specs as needed to characterize their capacity at different connection sizes. 


As an example, a device might have the following Traffic Specs: 


e TSpeci = TxRx, 2, 5000; 

e TSpec2 = TxRx, 128, 4700; 
e TSpec3 = TxRx, 256, 4000; 
e TSpec4 = TxRx, 508, 2800; 


In the example above, at a connection of size 2, the device can support 5000 packets per 
second. At a connection size of 128, the device can support 4700 packets per second. Linear 
interpolation is used to determine the capacity (packets per second) between those two sizes. 


TSpecN entries shall be numbered consecutively, starting with N = 1. TSpecN entries shall be 
listed in order of increasing ConnSize. The first TSpec entry (TSpec1) shall use the smallest 
ConnSize supported by the device. The last TSpec entry shall use the largest ConnSize 
supported by the device. 


Traffic Specs apply to a device’s implicit communications capacity only. For EtherNet/IP and 
ControlNet devices, Traffic Specs shall apply to implicit connections that specify transport 
class 0 or transport class 1. For DeviceNet devices, Traffic Specs shall apply to implicit 
connections regardless of the transport class. 


7-3.6.11.2 Generating TSpec Values 


Each TSpec shows the device’s maximum implicit packets per second at a given connection 
size. TSpecs should be generated over the range of connection sizes supported by the device. 
At each chosen connection size, the maximum packets per second should be determined using 
the smallest (fastest) RPI over the fewest number of connections possible. The recommended 
procedure to generate a Traffic Spec is outlined below: 


e Establish an I/O connection to the device (or, from the device if it is an originator). Note: 
packets sent on the connection shall be a fixed size. 

e Start with smallest RPI supported by the device. 

e Measure the sustained packet rate (using a network analyzer, device diagnostics, or other 
means). 
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e Determine whether packets are being lost (using a network analyzer, device diagnostics, 
observing connection loss, or by other means). 

e If there is packet loss, then increase the RPI (decrease packet rate) until no packets are 
being lost. 

e If no packet loss, and if the RPI cannot be made any faster, then add connections until the 
device experiences packet loss or runs out of connections (RPIs for subsequent connections 
may need to vary). 

e PacketsPerSecond for the TSpec shall be the measured packet rate. If the T->O and O->T 
(produced and consumed) connection sizes are not equal, then additional calculations must 
be done to generate the PacketsPerSecond number (see below). 


Vendors should determine whether a device has the same capacity for Tx and Rx packets. If 
the device has a significant difference in Tx and Rx capacities, then it is desirable, though not 
required, to generate different Tx and Rx TSpecs. There are several options for generating 
separate Tx and Rx TSpecs: 


1. using a null connection type in one direction 


2. measuring Rx packet rates while holding the Tx packet size and rate constant (and vice 
versa for Tx packets) 


Generating TSpec values can be difficult in that devices and the application software may 
support a limited number of connection sizes, and the connection sizes may be different in the 
T->O and O->T (produced and consumed) directions. For example, consider a device where 
the T->O connection size is 256, the O->T connection size is 2, and the maximum packet rate is 
measured at 4000 packets per second (2000 in each direction). Since different packet sizes are 
used, it is not possible to conclusively determine the maximum packet rates for the 2-byte and 
256-byte sizes. We assume that at 2 bytes the device can process at least 4000 packets per 
second. At 256 bytes, we assume the device can process somewhere between 2000 and 4000 
packets per second. In this situation, the recommended approach is to estimate the maximum 
packet rates at each of the two connection sizes, and then validate experimentally by setting up 
a number of connections and measuring packet rates or device CPU utilization if available. 


It is acceptable for vendors to generate TSpecs in accordance with the device’s limitations. For 
example, devices may support limited connection sizes and RPIs. If a device supports only a 
single fixed connection size then the device would have only one TSpec. If the device supports 
multiple connection sizes, then there shall be at least one TSpec at the minimum size, and one 
at the maximum size. Between the minimum and maximum, vendors should provide enough 
TSpecs to adequately characterize the I/O capacity of their devices. 


After generating TSpec values, vendors should validate the TSpecs by setting up actual 
application connections over the range of supported connection sizes, RPI’s, and number of 
connections to ensure that the device supports what the TSpecs state. 


7-3.6.11.3 Connection Overhead 


The number of connections can also have an affect on a device’s I/O capacity, independent of 
connection size and RPI. For example, due to connection management overhead, a device may 
be able to process 4000 packets with 2 connections, but only 3000 packets with 128 
connections (given the same packet size). 
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To account for connection overhead, the ConnOverhead keyword shall indicate a processing 
overhead to add per connection. ConnOverhead shall be expressed as a decimal number, 
representing the percentage of processing overhead for each connection (e.g., a value of .002 
represents .2% overhead per connection). The value of ConnOverhead shall be less than 1. 


Refer to the section on 7-3.6.11.6, Calculating Implicit Communications Usage for a 
description of how ConnOverhead is used. 


The following shows an example of a ConnOverhead entry: 
ConnOverhead = .002; 


In the above example, for each connection there is a processing overhead of .002 (or .2%). 


Devices are not required to include a ConnOverhead entry. Devices that do not incur 
additional overhead related to connection processing would typically not include a 
ConnOverhead entry. 


7-3.6.11.4 Determining ConnOverhead Values 


Values for the “ConnOverhead” parameters shall be determined by one of the following 
methods: 


1. Ata given packet rate, measure the device’s CPU utilization (if available and accurate) at 1 
connection and at the maximum number of connections supported by the device. 
ConnOverhead is the percent difference (expressed as a decimal number) in CPU 
utilization at 1 connection and at the maximum number of connections. 


2. Ata given connection size, measure the maximum packet rate at 1 connection (or at the 
smallest number of connections needed to generate max packet rate), and at the maximum 
connections supported by the device. ConnOverhead is the percent difference (expressed as 
a decimal number) in the maximum packet rate at 1 connection and at the maximum 
number of connections. 


If possible, devices should determine their Traffic Specs using the smallest number of 
connections (ideally 1), and then determine their ConnOverhead using the methods outlined 
above. Otherwise, if the Traffic Specs are generated using a significant number of connections 
(relative to the maximum connections supported), then the connection-processing overhead will 
be accounted for in the Traffic Spec. 


Some devices may have difficulty identifying connection overhead independent of their Traffic 
Specs. For example, a device that supports RPIs no faster than 50 ms may require a significant 
number of connections in order to generate a Traffic Spec. In this case, connection-processing 
overhead is already accounted for in the Traffic Spec. If the device also includes a 
ConnOverhead entry, the connection overhead would be included a second time. 


If a device requires a significant number of connections (relative to the maximum number of 
connections supported) to generate its Traffic Specs, then the device should generally not 
include a ConnOverhead entry. 
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7-3.6.11.5 Capacity Assumptions 


It is important that EDS capacity parameters be consistently interpreted and reported across 
different products. Values for capacity parameters — Traffic Spec rates, Connection Overhead, 
etc. — shall be assumed to indicate the device capacity that can be sustained under normal 
operating conditions in the absence of other (non-I/O) traffic, including: 


e other CIP traffic (e.g., Class 3) 
e non-CIP traffic (e.g., HTTP for EtherNet/IP devices, etc.) 
e rejected multicast packets (due to limitations of Ethernet multicast filtering) 


Future specification enhancements could address the effects of non-I/O traffic on I/O capacity. 


7-3.6.11.6 Calculating Implicit Communications Usage 


There are no requirements for particular behavior of a software tool that uses the capacity 
parameters. This section suggests an algorithm that could be used by a software tool to 
calculate and report device capacity. 


A software tool would typically use the EDS capacity parameters in order to determine an 
application’s projected communications usage. The tool would calculate, for each device in the 
application, the percentage of implicit communications capacity required by the configured 
connections. The tool could then report the percent utilization for each device, and whether any 
device has exceeded its capacity. 


To calculate projected implicit communications usage, the software tool might do the 
following: 


For each connection originator 


For each configured implicit connection 
Calculate the O->T (consumed) packet rate based on O->T RPI 
Find the TSpec corresponding to the O->T size. If the connection size is variable, 
assume all packets are the largest size. Use linear interpolation if between TSpecs. 
Determine the percentage of packet capacity used by O->T traffic and add to the sum 
of connection percentages for both originator and target 


Calculate the T->O (produced) packet rate based on T->O RPI 

Find the TSpec corresponding to the T->O size. If the connection size is variable, 
assume all packets are the largest size. Use linear interpolation if between TSpecs. 
Determine the percentage of packet capacity used by T->O traffic and add to sum of 
connection percentages for both originator and target 


For each connection originator and for each target 


Multiply the ConnOverhead times the number of connections and add to the sum of 
connection percentages. 
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7-3.6.11.7 Connection Capacity Keywords 


In addition to implicit communications capacity, it is useful for a device to provide information 
on the number of CIP connections supported, for both I/O and explicit communications. 
Connection capacity keywords are an important factor in allowing the user to determine 
whether the system as configured can successfully operate. 


Characterizing a device’s connection capacity is complicated by several factors: 


e Depending upon implementation, multicast connections may share connection resources if 
they produce or consume the same data. 

e CIP implementations may use different models for counting and limiting their connection 
resources 


In order to account for different implementations, a number of connection capacity keywords 

are defined (refer to Table 7-3.41). As documented in Chapter 3, the term “connection” refers 
to the communications entity created using the Create service of the Connection Object, or the 
Forward_Open service of the Connection Manager Object. 


The connection capacity keywords are further described below: 


e Maximum CIP connections (MaxCIPConnections) — the maximum number CIP 

connections supported, including both I/O and explicit connections. 

e Maximum I/O connections (MaxIOConnections) — the maximum number of I/O 

connections. 

e Maximum explicit connections (MaxMsgConnections) — the maximum number of 

explicit message connections. 

e Maximum I/O producers (MaxIOProducers) — the maximum number of I/O link 

producers. 

e Maximum I/O consumers (MaxIOConsumers) — the maximum number of I/O link 

consumers. 

e Maximum I/O producers plus consumers (MaxIOProduceConsume) — the maximum 

total of I/O link producers and consumers combined. 

e Maximum I/O multicast producers (MaxIOMcastProducers) — the maximum number 

of multicast link producers. 

e Maximum I/O multicast consumers (MaxIOMcastConsumers) — the maximum number 

of multicast link consumers. 

e Maximum consumers per multicast connection (MaxConsumersPerMcast) — the 
maximum number of consumers allowed to join any one multicast connection. 


The connection capacity keywords are conditional. The keywords may be used in particular 
combinations to model different approaches to counting and limiting connection resources. 
The allowable combinations of connection capacity keywords are show in the following table: 
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Table 7-3.41 Allowable Combinations of Capacity Keywords 


Allowed Combination of Description of Connection Counting Model Additional Capacity 
Connection Capacity Keywords Allowed 
Keywords (Optional) 
MaxCIPConnections The device counts CIP connections, with a MaxConsumersPerMcast 
common pool for both I/O and explicit message 
connections 
MaxJOConnections The device counts CIP connections, with separate | MaxConsumersPerMcast 
MaxMsgConnections limits on I/O and explicit messaging connections. 
MaxIOProduceConsume The device counts I/O and explicit message MaxIOMcastProducers 
MaxMsgConnections connections differently. For I/O connections the | y4ax]OMcastConsumers 
device counts producers and consumers. Each 
connection requires zero or one producer and MaxConsumersPerMcast 
zero or one consumer. Producers and consumers 
share a common pool. Multicast connections that 
request the same data are able to share producer 
and consumer resources. 
For explicit messaging connections the device 
counts connections. 
MaxIOProducers Same as the above model, except I/O producers | MaxIOMcastProducers 
MaxIOConsumers and consumers are maintained in separate pools. | y4ax]OMcastConsumers 
MaxMsgConnections MaxConsumersPerMcast 


The connection capacity keywords are typically a result of limits built into a product’s 
firmware or software. No measurement is generally needed to determine these limits, however 
it is expected that a product shall support the limits as stated in its EDS file. 


7-3.6.11.8 Considerations for Multiport Devices 


Devices may have multiple ports, of the same type or different types. The keywords in the 
[Capacity] section shall apply device-wide, across all ports. 


Figure 7-3.21 Sample Electronic Data Sheet illustrating the Capacity Section 


[File] 

[Device] 

[Capacity] 
TSpeci = TxRx, 2, 5000; packets per sec @ 2 bytes 
TSpec2 = TxXRx, 128, 4700; packets per sec @ 128 bytes 


TSpec3 = TxRx, 256, 4200; 
TSpec4 = TxRx, 508, 3400; 
ConnOverhead = .002; 
MaxCIPConnections = 128; 
MaxConsumersPerMcast = 64; 


packets per sec @ 256 bytes 

packets per sec @ 508 bytes 

conn overhead 

no more than 128 total connections 
64 consumers per multicast connection 


PRA AAAS 
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7-3.6.12 Event Enumeration Section 


The Event Enumeration section [EventEnum] associates specific event or status codes within a 
device to an international string. The events identified may represent any event, 
error(including error response codes) or other condition within a device. 


Events may be enumerated by the EventN entry keyword(s). There may be as many EventN 
entry keywords as necessary to identify all of the errors needing association. 


Table 7-3.42 Fields in the EventN entry keyword 


Field Name Field Number 
Object Reference 


Data Type Required/Optional 
EPATH Required 
Reserved 
Event Code 1 
Additional Code 1 


empty 

UDIN Required 
UDINT Optional 
STRINGI Required 
UDINT Optional 
UDIN Optional 
STRINGI Conditional 


el 


Associated String 1 
Event Code 2 
Additional Code 2 
Associated String 2 


el 


Event Code J (J-1)*3 +3 UDIN Optional 
Additional Code J (J-1)*3 +4 UDINT Optional 
Associated String J (J-1)*3 +5 STRINGI Conditional 


el 


Where: 


e Object Reference — This field shall only contain one of the following: 

e an EPATH identifying the object instance address (only Logical encoding of object class 
and explicit instance number) 

e anEPATH identifying all instances of a specific class (only Logical encoding of object 
class and no instance specified) 

e = anull entry 


This object reference is used to associate the following Error/Additional code(s) with the 
identified object(s). 


A null entry specifies any instance of any object. If this field is null, then (1) the 
Additional Code field shall also be null and (2) the Event Code shall be within the non- 
object specific range. 


When this field is not null it identifies some specific object instance (or object instances) 
within the device. The absence of an instance number specification indicates that the 
event enumerations pertain to any instances (including instance zero) of the related object. 


e Reserved — This field shall be entered as a null field. This field is reserved for future 
expansion of the EventN entry keyword. 

e Event Code n-— This field specifies an Event Code that is combined with the Object 
Reference and Additional Code fields to form a unique event identification. 
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e Additional Code n — This field specifies an additional (code qualification) value that is 
combined with the Object Reference and the Event Code fields to form a unique event 
identification. The presence of a null field indicates any value is acceptable to form a value 
match. 

e Associated String n — This international string is associated with the error identification. 
This field is required when Event Code n is specified. 


The matching of an actual event condition (from an instance of a class and associated event and 
additional code) with a specific EventN entry keyword is dependant upon an application 
performing matching activities in the following order: 


1. Actual error condition exactly matches an EventN entry keyword that explicitly specifies 
class and instance. 


2. Actual error condition exactly matches an EventN entry keyword that explicitly specifies 
class and defaults to any instance (including instance zero). 


3. Actual event condition’s Event code matches an EventN entry keyword with null Object 
Reference (e.g. no class or instance specified) and exact match for Event code. 
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An example of an [EventEnum] section is shown below: 


Eventi = “20 20 24 02”, $ Object identification: Analog Input Group 
$ Instance 2 only 
; $ Reserved Field 
Be Soo 
$ Error code ©x1F, Minor 0x00 
Ox1F, 0x00, $ Vendor specific error w/ additional code 0 
{2, 


{"eng",0xD0,4,""Message text 1" }, 
{"deu",0xD0,4,"Anzeigetext 1" } $ 


}, 


Ox1F, 0x05, $ Vendor specific error w/ additional code 5 
{ 2, 

{"eng",0xD0,4,'""Message text 2" }, 

{"deu",0xD0,4,"Anzeigetext 2" } $ 


}, 


QxOC, OXFF, $ Object state conflict translation 
J 

{ 2, 

{"eng",0xD0,4,'"Message text 3"}, 

{"deu",0xDO,4, "Anzeigetext 3"} $ 


}, 


Qx10, 0x00, $ Device state conflict translation 
{ 2, 

{"eng",0xD0,4,'"Message text 4"}, 
{"deu",0xD0,4,"Anzeigetext 4"} $ 


}, 


Qx10, Ox01, $ Another device state conflict translation 
{ 2, 

{"eng",0xD0,4,'"Message text 5"}, 

{"deu",0xD0,4,"Anzeigetext 5"} $ 


}; 
Event2 = “20 01 24 03”, $ Instance 3 of identity 
i $ Reserved Field 
0x10, 0x04, 
{ 2, 


"eng",0xDO,4,"Subnet communication in progress - Try again later"}, 
g prog y ag 
{"deu",0xD0,4,"Subnetzkommunikation lauft - Versuchen Sie es noch einmal 


spater"} $ 
3; 
Event4 = “20 02”, $ Message Router (any instance) 


i $ Reserved Field 
0x10, 0x01, 
{ 2, 
{"eng",0xD0,4,"EEPROM update in progress - Try again later"}, 
{"deu",0xD0,4,"EEPROM Update lauft - Versuchen Sie es noch einmal 


spater"} $ 
}, 
@x10, 0x02, 
“ft 2, 


{"eng",0xD0,4,"Failed to initialize analog channel(s)"}, 


— 7-80 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 7: Electronic Data Sheets 


{"deu", 0xD0,4, "Analogkanal(-kanale) konnte(n) nicht initialisiert 
werden"} $ 


}, 


0x10, 0x04, 

{ 2, 

{"eng",0xD0,4, "Remote communication channel active"}, 
{"deu", 0xDO, 4, "Remotekommunikationskanal aktiv"} $ 


}; 
Event5 = “”, $ Any Object, Any instance 
; $ Reserved Field 
Ox1F, , $ (Note - Null add code also) 
{ 2, 


{"eng",0xD0,4,"Subnet devices unresponsive"}, 
{"deu",0xD0,4,"Gerate im Subnetz antworten nicht"} $ 


ti 
7-3.6.13. Symbolic Translation Section 


The [SymbolicTranslation] section is used to publicize the translation between a Symbolic 
Segment or an ANSI Extended Symbol Segment encoded EPATH specification to the 
equivalent ParamN or AssemN entry keywords. Use of this section is required when a device 
utilizes a symbolic segment form of encoding within the EDS file. 


The entry keyword for all symbolic translations shall consist of the character array, 
"Symbolic", combined with a decimal number, forming a unique keyword. 


Table 7-3.43 Fields in the Symbolic Keyword 


Field Name Field number Required/Optional 


Symbolic Definition 1 EPATH Required — Shall be a 
single symbolic segment 
specification 


Translation ParamN or Required — Shall be 
AssemN ParamN or AssemN 
entry keyword reference 


DeviceNet Specific Example: 


[10_Info] 
Default = 0x0001; $ Poll connection is default 
PollInfo = 0x0003, 1, 1; 
StrobeInfo = 0x0003, 2, 0; 


Input1 = 2, 16, ©x0001, “Specific volts”, 2, “61 41”; 
Input2 = 8, 64, 0x09002, “HMI Data”, 2, “61 42”; 
Output1 = 1, 8, 0x0001, “Motor Control”, 7, “66 4D 6F 74 6F 72 34”; 


[SymbolicTranslation] 


Symbolici = “61 41”, $ The symbol “A” translates to 

Param22; $ item described by Param22 
Symbolic2 = “61 42”, $ The symbol “B” translates to 

Assemi3; $ collection described by Assem13 
Symbolic3 = “66 4D 6F 74 6F 72 34”, $ The symbol “Motor4” is describedby 

Assem56; $ AssemS6 entry keyword 
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Logical address within the device 
UINT 


“Volts per meter”, $ Units 

“RF energy at equator”; 

Params = , 

6, “20 19 24 01 30 03”, $ Runi attribute in Control 
$ Supervisor 

®, @xC1, 1, $ BOOL 

“Run”, $ Name 

Be $ Unitless 

“When true, Motor runs forward”; 

Param9 = , 

6, “20 19 24 01 30 04”, $ Run2 attribute in Control 
$ Supervisor 

®, @xC1, 1, $ BOOL 

“Run2”, $ Name 

see $ Unitless 


y 
“When true, Motor runs in reverse”; 


[Assembly] 


Assem1i3 = “HMI Specific Data”, 
, $ No equivalent logical path 


8, $ Maximum size (8 bytes) 
0, $ Descriptor 

i $ Reserved fields 

16,, 

16,, 

16,, 

16, ; 


Assem56 = “Special Motor Control”, 


“20 04 24 CA 30 03”, $ Accessible as Assembly OxCA data attribute 
1; $ 1 byte 

0, $ Descriptor 

ne $ Reserved fields 

1, Params, $ First bit is Run1 

1, Paramg; $ Second bit is Run2 


Network Unspecific Example: 


[Assembly ] 
Assem1 = “Vendor Specific”, 
“20 04 24 01 30 03”, $ In the device as assembly instance 1 
A, $ 1 byte assembly size 
0, $ Descriptor 
rae $ Reserved fields 
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4, “61 41”, $ 4 bits from symbolic path “A” 
4, “61 42”; $ 4 bits from symbolic path “B” 


[SymbolicTranslation] 


Symbolici = “61 42”, $ The symbol “B” translates to 

“20 C7 24 02 30 11”; $ Object 199, Instance 2, Attribute 17 
Symbolic2 = “61 41”, $ The symbol “A” translates to 
Param22; $ item described by Param22 


7-3.6.14 Internationalization Section 


The Internationalization section begins with the keyword [Internationalization] and shall 
describe EDS fields that can be internationalized. The table below shows the additional entries 
in the Internationalization section. 


Table 7-3.44 EDS Entry Keywords in the Internationalization Section 


Product Name ProdName Optional 


Entry Name Entry Keyword Required/Optional 
Descriptive Text Optional 
Device Type String ProdTypStr Optional 


Parameter ParamN, Optional 
ProxyParamN, 
ProxiedParamN 


Enumeration EnumN Optional 


Group GroupN Optional 


Assembly AssemN, Optional 
AssemExaN, 
ProxyAssemN, 


ProxyAssemExaN, 
ProxiedAssemN, 
ProxiedAssemExaN 


Output OutputN, Conditional * 
OutputExaN 


Variant Optional 
VariantExaN 

Connection Optional 

Port Optional 

Input Conditional * 


1- This keyword is not allowed if the device is not a DeviceNet device. If the device is a 
DeviceNet device, see Volume 3. 
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7-3.6.14.1 Descriptive Text Entry Keyword 


The “DescText” entry keyword is optional and shall contain the formatted field shown in Table 
7-3.45. 


Table 7-3.45 DescText Keyword Format 


Field Name Field Number Data Type Required/Optional 
International Text 1 STRINGI Required 


7-3.6.14.1.1 International Text, Field 1 


A single line of international text displayed by the configuration tool. The EDS developer 
assigns a meaningful line of text for this entry. This field value overrides the “DescText” 
keyword field value in the [File] section. 


7-3.6.14.2 Device Type String Entry Keyword 


The “ProdTypeStr” entry keyword is optional and shall contain the formatted field shown in 
Table 7-3.46. 


Table 7-3.46 ProdTypStr Keyword Format 


Field Name Field Number Data Type Required/Optional 
International Type 1 STRINGI Required 


7-3.6.14.2.1 International Type, Field 1 


International text description of device type as shown in Chapter 6-7. The string for vendor 
specific device types is at the vendors’ discretion. This field value overrides the “ProdTypStr” 
keyword field value in the [Device] section. 


7-3.6.14.3 Product Name Entry Keyword 


The “ProdName” entry keyword is optional and shall contain the formatted field shown in 
Table 7-3.47. 


Table 7-3.47 ProdName Keyword Format 


Field Name Field Number Data Type Required/Optional 
International Name 1 STRINGI Required 


7-3.6.14.3.1 International Name, Field 1 


International text product name. Same as Identity Object, Attribute 13 (if Identity Object, 
Attribute 13 is defined). When displayed, truncation may occur to meet the display 
capabilities. This field value overrides the “ProdName” keyword field value in the [Device] 
section. 
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7-3.6.14.4 Parameter Entry Keywords 


The "ParamN", “ProxyParamN” and “ProxiedParamN” entry keywords are optional and shall 
contain the formatted fields shown in Table 7-3.48. These keywords correspond to the 
keywords of the same name in the [Params] section. When these keywords exist in the 
[Internationalization] section, fields 22, 23 and 24 for the corresponding ParamN, 
ProxyParamN or ProxiedParamN keyword in the [Params] section are overridden. 


Table 7-3.48 ParamN, ProxyParamN and ProxiedParamN Keywords Format 


Field Name Field Number Data Type Required/Optional 
International Parameter Name 1 STRINGI Required 
International Engineering Units 2 STRINGI Required 
International Help String 3 STRINGI Required 


7-3.6.14.4.1 International Parameter Name, Field 1 
The international textual parameter name. When displayed, truncation may occur to meet the 
display capabilities. 

7-3.6.14.4.2 International Engineering Units, Field 2 


The international textual display units character array. If necessary, truncation of the retrieved 
text occurs to meet the maximum character array length allowed. 


7-3.6.14.4.3 International Help String, Field 3 
The international textual help character array. If necessary, truncation of the retrieved text 
occurs to meet the maximum character array length allowed. 

7-3.6.14.5 Enumeration Entry Keyword 


The "EnumN" entry keyword is optional and shall contain the formatted fields shown in Table 
7-3.49. 


If the tool supports the [Internationalization] section this “EnumN” keyword shall override the 
“EnumN” keyword in the [Params] section. 


Table 7-3.49 EnumN Keyword Format 


Field Name Field Number Data Type Required/Optional 
Value 153;5).4. data type of associated Field 1 Required, other fields optional 
parameter 
International 2,4,6,... STRINGI Required if field N-1 is specified, not 
Enumeration allowed otherwise. 


7-3.6.14.5.1 Value, Field 1, 3, 5,... 
The value to enumerate. 
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7-3.6.14.5.2 International Enumeration, Field 2, 4, 6, ... 


The international string that enumerates the value in the preceding field. 


7-3.6.14.6 Group Entry Keyword 


The "GroupN" entry keyword is optional and shall contain the formatted field shown in Table 
7-3.50. 


Table 7-3.50 DescText Keyword Format 


Field name Field Number Data type Required/Optional 
Internationalized Group Name String | 1 STRINGI Required 


7-3.6.14.6.1 Internationalized Group Name String, Field 1 


The international textual group name. This field value overrides the corresponding “GroupN” 
keyword name field value in the [Group] section. 


7-3.6.14.7 Assembly Entry Keywords 


The "AssemN", "AssemExaN", “ProxyAssemN”, “ProxyAssemExaN”, “ProxiedAssemN” and 
“ProxiedAssemExaN” entry keywords are optional and shall contain the formatted fields 
shown in Table 7-3.51. These keywords correspond to the keywords of the same name in the 
[Assembly] section. 


Table 7-3.51 AssemN, AssemExaN, ProxyAssemN, ProxyAssemExaN, ProxiedAssemN and 
ProxiedAssemExaN Keywords Format 


Field name Field Number Data type Required/Optional 
Internationalized Assembly Name 1 STRINGI Required 


7-3.6.14.7.1 International Assembly Name, Field 1 


The international textual assembly name. This field value overrides the corresponding 
"AssemN", "AssemExaN", “ProxyAssemN”, “ProxyAssemExaN”, “ProxiedAssemN” and 
“ProxiedAssemExaN” keyword name field value in the [Assembly] section. 


7-3.6.14.8 Variant Entry Keywords 


The "VariantN" and "VariantExaN" entry keywords are optional and shall contain the 
formatted fields shown in Table 7-3.52. These keywords correspond to the keywords of the 
same name in the [Assembly] section. 


Table 7-3.52 VariantN and VariantExaN Keywords Format 


Field name Field Number Data type Required/Optional 
Internationalized Variant Name 1 STRINGI Required 
Internationalized Variant Help String | 2 STRINGI Required 
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7-3.6.14.8.1 International Variant Name, Field 1 


The international textual variant name. This field value overrides the corresponding 
"VariantN" and "VariantExaN" keyword name field value in the [Assembly] section. 


7-3.6.14.8.2 International Variant Help String, Field 2 


The international textual variant help string. This field value overrides the corresponding 
"VariantN" and "VariantExaN" keyword help string field value in the [Assembly] section. 


7-3.6.14.9 Connection Entry Keyword 


The "ConnectionN" entry keyword is optional and shall contain the formatted fields shown in 
Table 7-3.53. 


The "ConnectionN" keyword corresponds to the keywords of the same name in the 
[Connection Manager] section. 


Table 7-3.53 ConnectionN Keyword Format 


Field name Field Number Data type Required/Optional 
Internationalized Connection Name 1 STRINGI Required 
Internationalized Connection Help 2 STRINGI Required 
String 


7-3.6.14.9.1 International Connection Name, Field 1 


The international textual connection name. This field value overrides the corresponding 
"ConnectionN" keyword name field value in the [Connection Manager] section. 


7-3.6.14.9.2 International Connection Help String, Field 2 


The international textual connection help string. This field value overrides the corresponding 
"ConnectionN" keyword help string field value in the [Connection Manager] section. 


7-3.6.14.10 Port Entry Keyword 


The "PortN" entry keyword is optional and shall contain the formatted field shown in Table 7- 
3.54, 


Table 7-3.54 PortN Keyword Format 


Field name Field Number Data type Required/Optional 
Internationalized Port Name 1 STRINGI Required 


7-3.6.14.10.1 International Port Name, Field 1 


The international textual port name. This field value overrides the corresponding “PortN” 
keyword name field value in the [Port] section. 
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7-3.7 Modular EDS File Requirements 


This section describes the concept and contents of a Modular EDS and specifies the usage 
requirements. 


7-3.7.1 Modular Section 


The [Modular] section begins with the keyword [Modular] and shall describe a chassis based 
system. The two types of modular devices shall be: 


e Chassis; 
e Module. 


A [Modular] section that describes a chassis shall contain a required keyword 
“DefineSlotsInRack” as shown in Figure 7-3.22. The single field on this entry shall be a 16- 
bit unsigned integer (UINT) indicating the number of slots in the chassis. Even though an 
electronic key is defined for the chassis, it need not be addressable from the link. The SLOT 
keyword used in path definitions in the [Connection Manager] section shall range from 0 to the 
number of slots minus 1. The keyword “SlotDisplayRule” is optional. The single field on this 
entry shall be a parameter from the [Params] section (ParamN), which defines the translation 
between internal and external slot number. 


Figure 7-3.22 [Modular] section describing a chassis 


[File] 
DescText = "Wonder Chassis EDS file"; 
CreateDate = 09-01-1997; 


CreateTime = 17:23:00; 
Revision = 1.1; 
[Device] 
VendCode = 65535; 
VendName "Widget Works, Inc."; 


ProdType 101; 
ProdTypeStr = "Widget Works Generic"; 
ProdCode = 1; 


MajRev = 1; 
MinRev = 1; 
ProdName = "Widget Chassis"; 
Catalog = "1234-chassis"; 
[Params] 
Parami = 
0, $ first field shall equal 0 
is $ path size, path 
Ox0006, $ descriptor 
OxC6, $ data type: Unsigned 8-bit Integer 
1; $ data size in bytes 
"Slot Naming Convention", $ name 
ne $ units 
ae $ help string 
0,4,0, $ min, max, default data values 
0,0,0,90, $ mult, dev, base, offset scaling 
0,0,0,90, $ mult, dev, base, offset link not used 
0; $ decimal places not used 
Enumi = 


0, "n/a", 1, fa Oa 2, ae Lhe 3, "2" 4, moMs 
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[Modular ] 
DefineSlotsInRack = 5; 
SlotDisplayRule = Param1; 


A [Modular] section that describes a module shall contain the "Width" and "Rack" entries. 


The required entry with the keyword "Width" shall have two fields. The first field is required 
and indicates how many slots of the chassis are consumed by the module. The field shall be a 
16-bit unsigned integer (UINT). The second field is optional and indicates which slot of the 
module connects to the chassis. If this optional field is omitted, slot 0 of the module is the 
connecting slot. The field shall be a 16-bit unsigned integer (UINT). 


The entry keyword for all chassis, into which the module can be placed, shall consist of the 
character array, "Rack", combined with a decimal number. The numbers shall start at 1 for the 
first chassis, and shall be incremented for each additional chassis. Commas shall separate all 
fields, and a semicolon shall indicate the end of the entry. The fields for the "Rack" entries 
shall be as shown in Table 7-3.55. 


Table 7-3.55 Field for the Rack entry keyword 


Field name Field number Data type Required/Optional 

Vendor ID 1 UINT Required 
Product Type 2 UINT Required 
Product Code 3 UINT Required 
Major Revision 4 USINT Required 
Minor Revision 5 USINT Required 
reserved 6, 7,8 empty not used 

Legal Slot 9,10, 11... UINT Required 


The "Vendor ID", "Product Type", "Product Code", "Major Revision" and "Minor Revision" 
field shall identify the electronic key of the chassis into which the module may be placed. The 
reserved field shall be empty. The "Legal Slot" fields shall identify the slots into which the 
module may be placed. The EDS for the module shall contain one "Rack" entry for each 
chassis into which the module may be placed as shown in Figure 7-3.23. 


Figure 7-3.23 [Modular] Section Describing a Module With a Network Connection 


[Modular ] 
Width = 1; 
Rack1i = $ this module can only plug into 
65535, 101, 1, 1, 1,,,, $ slot 0 of this five slot chassis 
0; 


Rack2 = 65535, 101, 2, 1, 1,,,, 
0; 
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7-3.7.2 Modular Additions to Basic EDS Sections 


7-3.7.2.1 CIP Path Addition for Modular EDS Files 


A CIP Path in a Modular EDS file may also contain the other following references (in addition 
to the references specified in the CIP Path definition): 


e the keyword SLOT; 
e the keyword SLOT_MINUS_ONE; 


The keyword, SLOT, shall always evaluate to a USINT. The values substituted for the SLOT 
keyword shall correspond to the position of a module in a back plane. The keyword, 
SLOT_MINUS_ONE, shall always evaluate to a USINT. The values substituted for the 
SLOT_MINUS_ONE keyword shall correspond to the position of a module in the back plane 
minus 1. 


Path Ex. 1: “20 04 24 SLOT 30 03” 
If the module position is slot 4 the CIP resulting CIP path would be “20 04 24 04 30 03”. 
Path Ex. 2: “20 04 24 SLOT_MINUS_ONE 30 03” 


If the module position is slot 4 the CIP resulting CIP path would be “20 04 24 03 30 03”. 


7-3.7.2.2 Additions to the Modular Section 


A [Modular] section that describes a module that does not have a link addressable Identity 
object may contain the entry keyword "ExternalID". The keyword shall have a single field. 
This field shall be a byte string that identifies the module. Modules that may be placed into 
slot 0 shall have an addressable Identity object and shall have no "ExternalID" entry. 


A [Modular] section that describes a module that has a link connection and can be placed in 
slot 0 may contain the keyword “GenericID”. The keyword shall have a single value. This 
field shall be a byte string that shall be included in the data segment for a module connection in 
place of the ExternalID when no module keying is desired. 


A [Modular] section that describes a module that has a link connection and can be placed in 
slot 0 may contain the keyword “ExternalIDExactMatch”. The keyword shall have a single 
value, Yes or No. Yes shall indicate that the ExternalID specifies one specific device, No shall 
indicate that the ExternalID specifies one of a set of compatible devices. If the 
“ExternalIDExactMatch” does not exist the default condition shall be that the ExternalID 
specifies one specific device. 
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A [Modular] section that describes a module that has a link connection and can be placed in 
slot 0 may contain the entry keyword “Query”. This keyword shall have 4 fields. The first 
field shall be a path that identifies a link addressable attribute that contains an array of external 
identifiers: one for each slot in the chassis except slot 0. The second field shall be the service 
to use with the query path (i.e. 1 — get attribute all or 14 — get attribute single). The third field 
shall be an integer that determines the number of bytes used to identify each module and shall 
be in the range 1 to 16. If a double slot module is in the chassis, the external identifier for the 
module shall appear twice in the array returned from a query. A query shall only be addressed 
to a module in slot 0. The fourth field shall be the ExternalID returned when an empty slot 
exists. 


Figure 7-3.24 [Modular] Section Describing a Module Without an Identity Object 


[Modular ] 
Width = 1; 
Rack1 = $ this module can plug into 
65535, 101, 1, 1, 1,,,, $ slots 1, 2, 3 and 4 of 
1, 2, 3, 4; $ this five slot chassis 
Rack2 = 


65535, 101, 2, 1, 1,,,, 
Ay 25. Bp Bp S67 


y 


Query = “20 04 24 07 30 03”,1,2,”FF FF”; 
ExternalID = “12 34”; 

GenericID = “00 00”; 
ExternalIDExactMatch = No; 


7-3.7.2.3 Additions to the Parameter Section 


The “ProxyParam” and “ProxiedParam” keywords shall be used to describe parameters that 
are proxied by a CIP adapter device to another device that does not support the CIP protocol. 
An example of this is a ControlNet adapter module (the device proxying the connection) in a 
multiple slot I/O rack with an analog I/O module (the device the connection is proxied for). 


The “ProxyParam” shall exist in the EDS for the device that performs the proxy. 


The “ProxiedParam” keyword shall exist in the EDS for the device that the proxy is 
performed for. 


The information in the [Modular] section shall be used to associate EDS files containing 
“ProxyParam” keywords to EDS files containing “ProxiedParam” keywords. This 
association shall exist when both EDS files specify a matching Rack entry. 


The decimal number (that is combined with “ProxyParam” and “ProxiedParam”) shall be 
used to match a “ProxyParam” to a “ProxiedParam”. The field values of a matched 
“ProxyParam” and “ProxiedParam” pair shall be combined to constitute the same field value 
information that exists in a single “Param” entry. This combination shall be done by using the 
field value from the “ProxyParam” unless that field value is the keyword “Module”. When 
the field value specified in the “ProxyParam” is “Module” the field value specified in the 
“ProxiedParam” shall be used. It shall be legal to specify field values for “ProxiedParam” 
entries whose corresponding field value in the “ProxyParam” is not “Module”, however, 
these field value shall not by used, they shall exist only for documentation. 
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Another keyword may also exist in the [Params] section. This keyword shall be used to 
provide minimum, maximum and default values to be added to the “ProxyParam” minimum, 
maximum and default values. This entry keyword shall be “ProxyParamSizeAdder”, 
combined with the decimal number from the corresponding “ProxyParam” entry. Commas 
shall separate all fields, and a semicolon shall end the entry. Each “ProxyParam” entry shall 
consist of a Minimum Value, Maximum Value and Default Value fields. The definition of 
these fields matches the “Param” definitions. The “ProxyParamSizeAdder” keyword 
provides a means for an adapter on a module connection (“ProxyConnect”) to add adapter data 
to the module data and return the combined data on the connection. 


Another keyword may also exist in the [Param] section that corresponds to the “ProxyParam”, 
“ProxyEnum”. “ProxyEnum” has the same definition as “Enum” except it is associated with 
“ProxyParam” instead of “Param”. A second keyword may also exist in the [Param] section 
that corresponds to the “ProxiedParam”, “ProxiedEnum”. “ProxiedEnum” has the same 
definition as “Enum” except it is associated with “ProxiedParam” instead of “Param”. 


For bit fields specified in proxy keyword fields, the binary value shall allow a character of M 
(in addition to the 0 and 1 characters). The character M shall indicate to use the character 
specified in the proxied keyword field. 


For example, the descriptor bits for a ProxyAssemN whose value is 0b0000000000000001M 
shall indicate that the assembly is a fixed sized expanded rack assembly and the 
ProxiedAssemN defines the allow value edit setting. 


7-3.7.2.4 Additions to the Assembly Section 


The following entries are additional values allowed for the "Member Reference" field within 
the Assembly section: 


e ExternalID; 

e = InputSlotMask0; 

e = InputSlotMask1; 

e OutputSlotMask0; 
e OutputSlotMask1; 
e ConfigSlotMask0; 
e ConfigSlotMask1. 


The “ExternalID” keyword shall indicate the usage of the device “ExternalID” value in the 
case when device keying is desired or the “GenericID” value in the case when module keying 
is not desired. 


The “InputSlotMask0” keyword shall indicate the location of the input slot mask in the 
assembly. The preceding size field shall be required. An input slot mask is an array of bits 
which represents inclusion or exclusion of a modules target to originator data in this adapter 
rack connection. Bit 0 in this array represents slot 0, bit 1 represents slot 1, etc. 


The “InputSlotMask1” keyword shall indicate the location of the input slot mask in the 
assembly. The preceding size field shall be required. An input slot mask is an array of bits 
which represents inclusion or exclusion of a modules target to originator data in this adapter 
rack connection. Bit 0 in this array represents slot 1, bit 1 represents slot 2, etc. 
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The “OutputSlotMask0” keyword shall indicate the location of the output slot mask in the 

assembly. The preceding size field shall be required. An output slot mask is an array of bits 
which represents inclusion or exclusion of a modules originator to target data in this adapter 
rack connection. Bit 0 in this array represents slot 0, bit 1 represents slot 1,etc. 


The “OutputSlotMask1” keyword shall indicate the location of the output slot mask in the 

assembly. The preceding size field shall be required. An output slot mask is an array of bits 
which represents inclusion or exclusion of a modules originator to target data in this adapter 
rack connection. Bit 0 in this array represents slot 1, bit 1 represents slot 2 etc. 


The “ConfigSlotMask0” keyword shall indicate the location of the configuration slot mask in 
the assembly. The preceding size field shall be required. A configuration slot mask is an array 
of bits which represents inclusion or exclusion of a modules configuration data in the fwd_open 
of this adapter rack connection. Bit 0 in this array represents slot 0, bit 1 represents slot 1, etc. 


The “ConfigSlotMask1” keyword shall indicate the location of the configuration slot mask in 
the assembly. The preceding size field shall be required. A configuration slot mask is an array 
of bits which represents inclusion or exclusion of a modules configuration data in the fwd_open 
of this adapter rack connection. Bit 0 in this array represents slot 1, bit 1 represents slot 2, etc. 


The “ExternalID” combined with a number (decimal) keyword intended purpose is to allow 
individual device keying for adapter rack connections. It shall indicate the usage of the device 
“ExternalID” value in the case when device keying is desired or the “GenericID” value in the 
case when module keying is not desired. The decimal number specifies the slot of this 
“ExternalID”. 


The “ProxyAssem”, “ProxyAssemExa”, “ProxiedAssem” and “ProxiedAssemExa” 
keywords shall be used to describe assemblies that are proxied by a CIP adapter device to 
another device that does not support the CIP protocol. An example of this is a ControlNet 
adapter module (the device proxying the connection) in a multiple slot I/O rack with an analog 
I/O module (the device the connection is proxied for). 


The “ProxyAssem”/”ProxyAssemExa” keywords shall exist in the EDS for the device that 
performs the proxy; the “ProxiedAssem”/”ProxiedAssemExa” keywords shall exist in the 
EDS for the device that the proxy is performed for. The information in the [Modular] section 
shall be used to associate EDS files containing “ProxyAssem”/”ProxyAssemExa” keywords 
to EDS files containing “ProxiedAssem”/”ProxiedAssemExa” keywords. This association 
shall exist when both EDS files specify a matching Rack entry. 
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The decimal number (that is combined with “ProxyAssem”/”ProxyAssemExa” and 
“ProxiedAssem”/” ProxiedAssemExa”) shall be used to match a 
“ProxyAssem”/”ProxyAssemExa” to a “ProxiedAssem”/”ProxiedAssemExa”. The field 
values of a matched “ProxyAssem”/”ProxyAssemExa” and 

“ProxiedAssem”/” ProxiedAssemExa” pair shall be combined to constitute the same field 
value information that exists in a single “Assem”/” AssemExa” entry. This combination shall 
be done by using the field value from the “ProxyAssem”/”ProxyAssemExa” unless that field 
value is one of the keywords “Module” or “ModuleMemberList”. When the field value 
specified in the “ProxyAssem”/”ProxyAssemExa” is “Module” the field value specified in 
the “ProxiedAssem”/”ProxiedAssemExa” shall be used. The field value “Module” shall not 
be used for “Member Size” or “Member Reference” fields. “ModuleMemberList” shall only 
be used in place of a “Member Size” and “Member Reference” field pair. When the field value 
specified in the “ProxyAssem”/”ProxyAssemExa” is “ModuleMemberList” all “Member 
Size” and “Member Reference” fields specified in the “ProxiedAssem”/”ProxiedAssemExa” 
shall be used. It shall be legal to specify field values for 
“ProxiedAssem”/”ProxiedAssemExa” entries whose corresponding field value in the 
“ProxyAssem”/”ProxyAssemExa” is not “Module”, however, these field values shall not by 
used, they shall exist only for documentation. 


Figure 7-3.25 Example of ProxyParam and ProxyAssem 


[Params ] 
Parami = 0,,,0x0010,0xC7,2,” Target Error Codes", 
mu" @,OxFFFF,0,0,0,0,0,0,0,0,0,0; 
ProxyParam1 = 0,,,0x0000,0xC7,2,"input size", 
uu el Module, Module, Module,0,0,0,0,,,,,9; 
ProxyParamSizeAdder1 = 4,4,4; 


[Assembly ] 

Assem1 = "connection input format",,,,,, 
32,Param1, 
,ProxyAssem1, 
,ProxyAssem2; 

ProxyAssem1 = "real time input format","20 7D 24 SLOT 30 O0A",,,,, 
ModuleMemberList; 

ProxyAssem2 = "real time status format","20 7D 24 SLOT 30 OB",,,,, 
ModuleMemberList; 


[Connection Manager ] 
ProxyConnecti = 0x010100002, 0x44244401, 
2, 0, , 2, ProxyParam1, Assem1, , , , , "Listen Only", "", 
"@1 SLOT_MINUS_ONE 20 04 24 03 2C 04 2C 02"; 


Figure 7-3.26 Example of ProxiedParam and ProxiedAssem 


[Params] 

ProxiedParami = ,,,,,,"input size","","",0,O0XC7,2,,;;57777} 
[Assembly] 

ProxiedAssemi = "real time input format",,,,,; 

ProxiedAssem2 = "real time status format",,,,,,16,; 


[Connection Manager ] 
ProxiedConnect1 = VG OFED EI LEA 
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For bit fields specified in proxy keyword fields, the binary value shall allow a character of M 
(in addition to the 0 and 1 characters). The character M shall indicate to use the character 
specified in the proxied keyword field. 


For example, the descriptor bits for a ProxyAssemN whose value is 0b0000000000000001M 
shall indicate that the assembly is a fixed sized expanded rack assembly and the 
ProxiedAssemN defines the allow value edit setting. 


7-3.7.2.5 Additions to the Connection Manager Section 


The “ProxyConnect” and “ProxiedConnect” keywords shall be used to describe connections 
that are proxied by a CIP adapter device to another device that does not support the CIP 
protocol. An example of this is a ControlNet adapter module (the device proxying the 
connection) in a multiple slot I/O rack with an analog I/O module (the device the connection is 
proxied for). 


The “ProxyConnect” keyword entry shall exist in the EDS for the device that performs the 
proxy. In the example above, this would be the ControlNet adapter module. 


The “ProxiedConnect” keyword entry shall exist in the EDS for the device that the proxy is 
performed for. In the example above, this would be the analog I/O module. 


The information in the [Modular] section shall be used to associate EDS files containing 
“ProxyConnect” keywords to EDS files containing “ProxiedConnect” keywords. This 
association shall exist when both EDS files specify a matching Rack entry. 


The decimal number (that is combined with “ProxyConnect” and “ProxiedConnect”) shall be 
used to match a “ProxyConnect” to a “ProxiedConnect”. The field values of a matched 
“ProxyConnect” and “ProxiedConnect” pair shall be combined to constitute the same field 
value information that exists in a single “Connection” entry. This combination shall be done 
by using the field values from the “ProxyConnect” except for those fields where the value is 
the keyword “Module”. In those cases, the field value specified in the associated 
“ProxiedConnect” shall be used. It shall be legal to specify field values for 
“ProxiedConnect” entries whose corresponding field value in the “ProxyConnect” entry is 
not “Module”, however, these field values shall not be used, they shall exist only for 
documentation. The field value for the “ProxyConnect” “connection name string” field shall 
not be “Module”, the “ProxyConnect” shall always specify the “connection name string”. 
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8-1 Introduction 


The CIP application layer can be used on a variety of network technologies. Each CIP network 
specification consists of two volumes. This volume is not currently specifying any common 
physical layer behavior. See the appropriate CIP network adaptation volume for physical layer 
behavior defined on that network. 
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9-1 Introduction 


The CIP application layer can be used on a variety of network technologies. Each CIP network 
specification consists of two volumes. This volume is not currently specifying any common 
indicator or middle layer behavior. See the appropriate CIP network adaptation specification 
for indicator or middle layer behavior defined on that network. 
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10-1 Introduction 


The communication objects within Chapter 3, in particular services of the Connection 
Manager, provide bridging and routing between CIP subnets. This chapter will describe how 
bridging and routing is accomplished using those objects. 


10-2 CIP Routing 


The Forward_Open, Forward_Close, and Unconnected_Send services of the Connection 
Manager object allow for routing of messages and for the establishment of connections across 
bridges. Use of the Port Segment within the Connection Path parameter of the above services 
provides the routing information. The Port Segment encoding is described in Appendix C. 
Routing is ‘fixed path’ (data will always follow the same path); this is critical for insuring 
consistent I/O transaction times. 


Each Port Segment represents a ‘hop’ in the path, from one subnet to another, and the CIP 
router removes its Port Segment from the path before forwarding the service to the next 
destination. The Port Segment tells the router which port (subnet) to send the message on and 
the node address of the destination node on that subnet. The final target receives a Connection 
Path with no Port Segments remaining. 


A connection originator can use the Port Object within each CIP router to determine the types 
of subnets, which can be reached (routed to) through that device. The Port Object, described in 
Chapter 3, provides the port name, port number within the device, and other port information 
for each routable port on the device. 


10-3 Object Addressing Space 


A CIP router may actually be the Target Device in an Unconnected Send Request. One use for 
this would be to access link specific objects within the address space of port, which is not the 
port the request entered on. Link type objects (such as the ControlNet Object, DeviceNet 
Object, Connection Manager Object or Connection Object) within a device may (and in some 
cases are required to) have the same instance numbers on each port. 


For example, considering a device containing multiple DeviceNet ports, requesting an attribute 
within instance one of the DeviceNet Object on a port will always return the value associated 
with the DeviceNet object on that port. Since the DeviceNet object associated with a different 
port is also addressed as instance one, it is necessary to ‘route’ to that object. The following 
diagram shows a possible internal object layout for a router. Note that in this example Port 
Object instance 1 is Port number 2 and Port Object instance 2 is Port number 3. 
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Figure 10-3.1 Object Address Space within a CIP Node 
Device Addressable Objects 
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Object Object Object Object Object 
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In this example, a request to Instance 1 of the DeviceNet Object entering on Port 2 (Node 
Address 3) will be serviced by the DeviceNet Object in Port 2’s object space. In order to 
access Instance 1 of the DeviceNet Object in Port 3’s object space, the Unconnected Send 
service of the Connection Manager Object for Port 2 needs to be used. The Route_Path 
parameter within the Unconnected Send service would contain 03 07 indicating that the request 
should be routed to Port 3 within the device, Node 7 on that network. The router must detect 
that it is Node 7 on the network with which Port 3 is connected, process the request 
accordingly, and send a response. 


— 10-4 —- 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 10: Bridging and Routing 


10-4 


CIP Routing Behavior 


The table below presents the Events that a Connection Manager Object instance experiences 


and the appropriate actions to take. 


Table 10-4.1 CIP Routing Event/Action Matrix 


Event Description 


Connection Manager Object Instance receives a valid 
Unconnected Send Request that DOES NOT need to be 
forwarded on through more intermediate hops. 


Connection Manager Object Instance receives an 
invalidly formatted Unconnected Send Request. 


Failure to execute the Explicit Messaging transaction 
with the Remote Target Device. This is due to: 


e —_ Failure to establish an Explicit Messaging 
Connection 


e Open Explicit Messaging Connection Error 
Response 


e Timeout waiting for the Explicit Messaging 
Response. 


Failure to execute the Unconnected Send transaction 
with the next CIP Router in the path. This is due to: 


e —_ Failure to establish an Explicit Messaging 
Connection 


e Open Explicit Messaging Connection Error 
Response 


e Timeout waiting for the Unconnected Send 
Explicit Messaging Response. 


Unconnected Send Request is received but it cannot be 
processed due to an internal resource error (e.g. queue 
overflow, no buffers available, etc.). 


Connection Manager Object Instance receives a valid 
Unconnected Send Request that needs to be routed 
through more intermediate hops before it reaches its 
final destination network. 
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Action to Take 


Process and update the timing parameters’. Internally 
route the request to the specified port’s protocol engine. 
Establish an Explicit Messaging Connection with the 
Remote Target Device. Extract the Explicit Messaging 
Request parameters from the Message Request portion of 
the Unconnected Send Service Data. Deliver the Explicit 
Messaging Request to the Remote Target Device. Start a 
“wait for response” timer whose value is the number of 
milliseconds specified by the current (updated) timing 
parameters. 


Return a Routing Error that conveys the detected 
problem. See the Packet Validation section below for 
more details. 


Return a Routing Error with the following settings: 
e —_ General Status field is set to 01 


e Additional Status array contains a single UINT 
value of 0x0204 


e —remainingPathSize is set to the value zero (0). 


Return a Routing Error with the following settings: 
e General Status field is set to 01 


e Additional Status array contains a single UINT 
value of 0x0204 


e Remaining Path Size is set to the number of words 
remaining in the “pre-stripped” path. 


Return a Routing Error with the following 
characteristics: 


e General Status field is set to 02 
e Additional Status array is empty 


e Remaining Path Size is set to the “pre-stripped” 
number of words remaining in the Route_Path field. 


Process and update the timing parameters’. Internally 
route the request to the specified port’s protocol engine. 
Strip off the appropriate portion of the routing 
information and update the Transaction_Id field if 
necessary. Establish an Explicit Messaging Connection 
with the next CIP Router and deliver the updated 
Unconnected Send Request accordingly. Start a “wait for 
response” timer whose value is the number of 
milliseconds specified by the current timing parameters 
(AFTER they have been updated). 


ODVA & ControlNet International, Ltd. 


Event Description 


Explicit Messaging Response OR an Unconnected 
Send Response is received by a CIP Router. 


CIP Router experiences a timeout while waiting for an 
Explicit Messaging Response from either another CIP 
Router (to which an Unconnected Send request had 
been forwarded) or the Remote Target Device (to 
which the actual Explicit Messaging Request had been 
delivered). 
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Action to Take 


Determine whether or not the Explicit Messaging 
Connection across which the associated Unconnected 
Send Request is still active (did not experience an 
Inactivity/Watchdog timeout). Determine whether or not 
a timeout error has already been returned for this 
transaction. If the Explicit Messaging Connection is still 
active and a routing error has yet to be returned for this 
transaction, then formulate the appropriate Unconnected 
Send Response and return it across that Explicit 
Messaging Connection. This may entail restoring the 
requester’s Transaction_Id field on DeviceNet. Ifa 
Routing Error has already been returned OR the Explicit 
Messaging Connection is no longer active, then the CIP 
Router shall discontinue all processing associated with 
this transaction. 


Return a Routing Error with the following settings: 
e General Status field is set to 01 


e __ Additional Status array contains a single UINT 
value of 0x0204 


e —_ remainingPathSize is set to the number of words 
remaining in the “pre-stripped” path. 


= Any time a Connection Manager Object receives an Unconnected Send Request it SHALL process the timing 


parameters. 


? _ Whenever an Unconnected Send Request/Response is transmitted/received, a counter within the Connection 
Manager Object Instance associated with the port across which this transmission/reception took place shall be 


incremented. 
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10-5 


10-5.1 


DeviceNet Modifications 


The services of the Connection Manager are not supported by DeviceNet nodes when it is the 
target of the request. Thus, only nodes which provide routing to/from DeviceNet support the 
Connection Manager object. When the target node of a message is on DeviceNet, these routers 
are required to translate the message into normal DeviceNet explicit messaging format. As a 
result, DeviceNet nodes require no changes to accept routed messages from other CIP subnets. 


In order to allow these routers the ability to handle multiple outstanding transactions on 
DeviceNet, the Unconnected Send service of the Connection Manager is modified when 
traversing a DeviceNet subnet. The details are provided in 10-5.1 and 10-5.2 below. 


Unconnected Send Service Request Modification 


When sent on a DeviceNet subnet, the Unconnected Send service data is prepended with a 16- 
bit transaction ID. This transaction identifier is generated by the requesting device and 
returned by the router along with the response from the target. The modified service request is 
as Shown below. 


Table 10-5.1 Unconnected Send Service Parameters 


Parameter Name Data Type Description 


Transaction_ID UINT Used for transaction management in the DeviceNet Requesting Device 
and DeviceNet Routers. This field is used for transaction matching by 
message originators on DeviceNet not passed on to other subnets 


Priority/Time_tick BYTE Used to calculate request timeout information. 
Time-out_ticks USINT Used to calculate request timeout information. 
Message_Request_Size UINT Specifies the number of bytes in the Message Request. 
Message_Request’ Struct of 


Service USINT Service code of the request. 


Request_Path_Size USINT The number of 16 bit words in the Request_Path field (next element). 


Request_Path Padded This is an array of bytes whose contents convey the path of the request 
EPATH (Class ID, Instance ID, etc.) for this transaction. 
Request_Data Array of Service specific data to be delivered in the Explicit Messaging Request. 
octet If no additional data is to be sent with the Explicit Messaging Request, 
then this array will be empty. 
Pad USINT Only present if Message_Request_Size is an odd value. 
Route_Path_Size USINT The number of 16 bit words in the Route_Path field. 


Reserved USINT Reserved byte. Shall be set to zero (0). 


Route_Path Padded Indicates the route to the Remote Target Device. 
EPATH 


' This is the Message Router Request Format as defined in Chapter 2. 
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10-5.2. Unconnected Send Service Response Modification 


A DeviceNet router shall always return a successful response to an Unconnected Send service 
request. This success response may actually indicate that an error was encountered. This is 
necessary because additional error information is needed to handle routing errors and this 
additional information does not conform to the Error Response format defined for DeviceNet. 
As specified in Chapter 3, the Service code returned may be either the service code sent inside 
the Unconnected Send service data or the Unconnected Send service code. The 0x94 Error 
Response Service is never returned. 


The modified successful and unsuccessful service responses are as shown below. Note that this 
is the data placed within the DeviceNet Service Data area; the reply service code is earlier in 
the packet. 


Table 10-5.2 Successful Unconnected Send Response 


Get_Attribute_Single request. If the Explicit Messaging response returned by 
the Target Device/Object did not contain any Service Data, then this field shall 
be empty. 


Parameter Data Type Description 
Name 
Transaction_ID | UINT Echoes the value received in the associated Unconnected Send Request. 
General Status | USINT This value is zero (0) for successful transactions. 
Reserved USINT Shall be zero. 
Service Array of This field contains the Explicit Messaging Service Data returned by the Target 
Response Data | byte Device/Object. For example, this would contain Attribute Data in response to a 


The response Service Data associated with an unsuccessful Unconnected Send response is 
defined below. 


Table 10-5.3 Unsuccessful Unconnected Send Response 


Parameter Name Data Type Description 
Transaction_ID Echoes the value received in the associated Unconnected Send 
Request. 
General Status USINT One of the General Status codes listed in Appendix B Error Codes. 


If a routing error occurred, it shall be limited to the values specified 
in the Routing Error Values table. 


Size of Additional USINT Number of 16 bit words in Additional Status array. 

Status 

Additional Status Array of UINT When returning an error from a target, which is a DeviceNet node, 
the Additional Status shall contain the 8 bit Additional Error Code 
from the target in the lower 8 bits and a zero (0) in the upper 8 bits. 

Remaining Path Size USINT This field is only present with routing type errors and indicates the 


number of words in the original route path (Route_Path parameter 
of the Unconnected Send Request) as seen by the router that detects 
the error. 


= 
Zz 
= 
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10-6 


10-6.1 


Examples 


This section presents examples to further clarify the operation of the Connection Manager 
Object and the Unconnected Send service. 


Using the Unconnected Send Service for Explicit Messaging — Single 
Hop 


Assume that the Requesting Device wants to execute a Get_Attribute_Single on Class 
#1/Instance #2/Attribute ID #3 in the Target Device. 


Figure 10-6.1 Single Hop Unconnected Send (Explicit Message Request/Response) 


Get_Attribute_SingleSpecifying Class #1/Instance#1/Attribute #1 


DeviceNet to EtherNet/IP Router 


Requesting Port ID = 2 Port ID =3 arget Device 
Device 


IP Address >| 
130.151.137.112 


MAC ID=5 


MAC ID=7 


DeviceNet EtherNet/IP 


The table below presents the contents of the Service Data field for the Unconnected Send 
request which is used to execute the Get_Attribute_Single example noted above (all values are 
in hex). 


Table 10-6.2 Single Hop Unconnected Send Request Service Data 


Bytes Meaning 
01 00 The Requesting Device generated Transaction_Id field. 
pp Priority/Tick Time field. 
tt Connection Timeout Ticks field. 
eC 00 Message_Size field = 12 bytes. Note that the Request_Data field is empty. 
OE Service field = Get_Attribute_Single. 
05 Request_Path_Size field indicates that there are 5 words in the path field. 


21 00 01 00 Path field specifying 16 bit Class Id = 1, 16 bit Instance ID = 2, 8 bit Attribute Id = 3. Note 

25 00 02 00 | the presence of the pad bytes immediately following the 0x21 and 0x25 bytes. This path could 

30 03 have also been formatted as follows: 20 01 24 02 30 03 which makes use of 8 bit values to 
convey the Class and Instance ID data. In the 8-bit case, the pad bytes are not required. 


09 Route_Path_Size field indicates that there are 9 words in the route path. 
00 Reserved byte. 
13 OF 31 33 Contents of the Route_Path field. This field specifies the routing information. These bytes 


30 2E 31 35 | indicate that the request is to be delivered out Port #3 and to IP Address 130.151.137.105. 


31 2E 31 33 This path encoding uses the Extended Link Address format for the IP address. 
37 2E 31 30 
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Step 1 — Request delivered to the DeviceNet to EtherNet/IP Router 


The first step in the process calls for the Requesting Device to establish an Explicit Messaging 
Connection with the DeviceNet to EtherNet/IP Router and issue the Unconnected Send request. 
The table below presents the entire Unconnected Send request. Assume that the Message Body 
Format established for the Explicit Messaging Connection is DeviceNet 8/8. 


Table 10-6.3 Explicit Message Request on DeviceNet 


Bytes Meaning 
07 Frag = 0', Transaction ID = 0, Destination MACID = 7. 
52 Service = 52. In this context, this specifies the Unconnected Send service. 
06 Class ID of the Connection Manager Object Class. 
01 The Instance ID Field specifying instance 1 of the Connection Manager. 


©1 00 pp tt OC OO | Unconnected Send Service Request Data. This is the previously described 
OE 05 21 00 01 00 | Unconnected Send service data describe above with the Transaction_Id field as the first 
25 00 02 00 30 O03 | UINT value (01 00 for this example). 


'_ This request would have to be fragmented to deliver it to the router. Fragmentation is not illustrated in this 
example. 


The Unconnected Send request has now been delivered to the DeviceNet to EtherNet/IP Router 
via an Explicit Messaging Connection that exists between the Requesting Device and the 
DeviceNet to EtherNet/IP Router. 


Step 2 — Router delivers the request to the Target Device 


When the Connection Manager Object within the DeviceNet Router receives the Unconnected 
Send request it examines the contents of the Route_Path field. In this case, the contents are “13 
OF 31 33 30 2E 31 35 31 2E 31 33 37 2E 31 30 35 00”. This indicates that the next device in 
the hop is on Port #3 and its Node (IP) Address is 130.151.137.105. Additionally, since there 
is only a single Port/Node Address pair specified in the Route_Path, the request has reached its 
destination network. When a DeviceNet Router receives an Unconnected Send Request that 
DOES NOT need to be forwarded through more intermediate CIP Routers, the following steps 
are taken: 


e The DeviceNet Router executes the timing related logic associated with the Priority/Tick 
Time and Connection Timeout Ticks fields. If a timeout is detected, then a successful 
Unconnected Send response that specifies a Routing Error is returned to the Requesting 
Device. 

e The DeviceNet Router extracts the actual transaction from the Message Request portion of 
the Service Data and delivers the Explicit Messaging Request to the Target Device. The 
actual method of delivering the explicit message is dependent on the link type. 


In this example, the message request inside the Unconnected Send indicates a 
Get_Attribute_Single to Class #1, Instance #2, Attribute #3. This approach has no effect on the 
Target Device. The Target Device does not even realize it has just responded to a request that 
originated on a remote DeviceNet. 
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Step 3 — Target returns the Explicit Message response to the Router 


The Target Device processes the explicit message and returns a response to the Router. When 
the Get_Attribute_Single Response is received by the DeviceNet Router it generates the 
Unconnected Send Response and internally delivers it to the Explicit Messaging Connection 
across which the Unconnected Send Request was originally received. 


Step 4 — Router returns the Unconnected Response to the Requesting Device 


The DeviceNet Router then delivers the Unconnected Send Response to the original 
Requesting Device. 


Assume that the Target Device returns a successful response to the Get_Attribute_Single and 
the requested attribute is a UINT whose value is 0x1234. The text below presents the contents 
of the CAN Data Field associated with the Unconnected Send Response returned to the 
Requesting Device: 


Table 10-6.4 Successful Explicit Message Response on DeviceNet 


Bytes Meaning 
05 Frag = 0, Transaction ID = 0, Destination MAC =5. 
8E Service = 8E. In this context, this specifies a response to the Unconnected Send service. 
01 00 The Transaction_Id field echoed back in the response. 
00 The General Status field. The value zero (0) indicates that there were no routing errors. 
00 The Success status has no additional status. 
34 12 The Target Device’s Explicit Messaging Response Service Data field. In this case, the value 0x1234 


was returned in the Get_Attribute_Single response. 


Now assume that the Target Device returned an Error Response whose General Error Code was 
set to the value “2” and whose Additional Error Code field was set to the value “5”. The text 
below presents the contents of the CAN Data Field associated with the Unconnected Send 
Response returned to the Requesting Device. The absence of the Remaining Path Size field 
indicates that this error (Error Code = 2) was returned from the Target Device, not an 
intermediate router. 


Table 10-6.5 Unsuccessful Explicit Message Response on DeviceNet 


Bytes Meaning 
05 Frag = 0, Transaction ID = 0, Destination MAC =5. 
8E Service = Ox8E. In this context, this specifies a response to the Unconnected Send service. 
01 00 The Transaction_Id field echoed back in the response. 
02 The General Status field. The non-zero value indicates there was an error. 
01 The Size of Additional Status field. This indicates that the Target Device returned 16 bits of 
additional status. 
05 00 This indicates that the Target Device returned an Additional Error Code of 0x05. 
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Finally, assume that the DeviceNet Router was unable to establish an Explicit Messaging 
Connection with the Target Device. In this case a Routing Error has occurred (the request was 
not delivered to the Target Device). The error code and extended status that most closely 
conveys the routing error is: General Code = 0x01, Extended Code = 0x0204 — Unconnected 
Send timed out waiting for a response (Note that error handling is dealt with in more detail in 
the Event/Action Matrix in 10-4). The text below presents the contents of the CAN Data Field 
associated with the Unconnected Send Response returned to the Requesting Device: 


Table 10-6.6 Routing Failure Explicit Message Response on DeviceNet 


Bytes Meaning 

05 Frag = 0, Transaction ID = 0, Destination MAC = 5. 

D2 Service = D2. In this context, this specifies a response to the Unconnected Send service. 

01 00 The Transaction_Id field echoed back in the response. 

01 The General Status field. This indicates that a routing error was detected. 

01 The Size of Additional Status field. This indicates that there is 16 bits of additional status. 

04 02 The Additional Status field. There is a single UINT whose value is 0x0204. 

00 The Remaining PathSize field. The value zero (0) indicates that an error was encountered during the 
attempt to establish communications with the Remote Target Device versus another DeviceNet 
Router. 


10-6.2 Using the Unconnected Send Service For Explicit Messaging — 
Multiple Hop 


Assume that the Requesting Device wants to execute a Set_Attribute_Single on Class 
#1/Instance #2/Attribute ID #3 in the Target Device. Assume that the data being sent to this 
attribute is a byte array whose value is 01 02 03 ... 09. Notice that this transaction will flow 
through two DeviceNet Routers. 


Figure 10-6.7 Multiple Hop Unconnected Send 


Set_Attribute_Single specifying Class #1/Instance #2/Attribut@sg3, Attribute Value = 01 02 


DeviceNet to DeviceNet DeviceNet to DeviceNet 
Router #1 Router #2 


Requesting 
Device 


Target Device 
PortID=3 PortID=2 PortID=3 PortID=4 


MAC ID=5 MAC ID =7 MAC ID =9 MAC ID =4 MAC ID =6 
DeviceNet #1 DeviceNet #2 DeviceNet #3 
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Step 1 — Request delivered to DeviceNet to DeviceNet Router #1 


The first step in the process calls for the Requesting Device to establish an Explicit Messaging 
Connection with DeviceNet to DeviceNet Router #1 and issue the Unconnected Send request. 
This is identical to Step #1 in the previous example. The text below presents the contents of the 
Unconnected Send request’s Service Data field, which is used to execute the 
Set_Attribute_Single noted above (all values are in hex). 


Table 10-6.8 Multiple Hop Unconnected Send Request Service Data (First Hop) 


Bytes Meaning 
01 00 The Requesting Device generated Transaction_Id field. 
07 Priority/Tick Time field (Time Tick = 128 ms). 
OC Connection Timeout Ticks field (12 Ticks, which results in 1536 ms timeout). 
11 00 Message_Size field = 17 bytes. Note that this means that a pad byte will be inserted 
between the Request_Data field and the Route_Path_Size field. 
10 Service field = Set_Attribute_Single. 
03 Request_Path_Size field indicates that there are 3 words in the request path. 
a3 oe 24 02 Request_Path field specifying 8 bit Class Id = 1, 8 bit Instance ID = 2, 8 bit Attribute Id = 3. 
01 02 03 04 Request_Data field specifying the attribute data associated with the Set_Attribute_Single 
05 06 07 08 request. 
09 
00 Pad byte (required due to the odd length). 
02 Route_Size field indicates that there are 2 words in the Route _Path. 
00 Reserved byte. 
02 09 04 06 Contents of the Route_Path field specifying the routing information. These bytes indicate 


that the request is to be delivered out Port #2 and to MAC ID 9 and then out Port #4 to the 
Target Device at MAC ID 6. 


Step 2 — Request delivered to DeviceNet to DeviceNet Router #2 


When DeviceNet Router #1 receives the Unconnected Send request with this Service Data field 
it detects that there are more intermediate devices to go through before the Target Device can 
be reached. In this case, DeviceNet Router #1 executes the following steps: 


e Executes the timing related logic associated with the Priority/Tick Time and Connection 
Timeout Ticks fields. If a timeout is detected, then a successful Unconnected Send 
response, which specifies a Routing Error, is returned to the Requesting Device. 

e Strips its portion of the routing information from the Unconnected Send request’s 
Route_Path field and forwards the Unconnected Send Request accordingly. In this 
example, the “02 09” bytes constitute the routing information pertinent to DeviceNet Router 
#1 (next hop indicator). These bytes indicate that the Unconnected Send Request should be 
sent out Port #2 and to MAC ID #9 on that subnet. 

e Establishes an Explicit Messaging Connection with DeviceNet Router #2 (if necessary) and 
sends the remaining data in the Unconnected Send service the second router. 
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The Service Data field of the Unconnected Send Request that DeviceNet Router #1 forwards to 
DeviceNet Router #2 is presented below. In this example, DeviceNet Router #1 is making use 
of the Transaction_Id field for internal transaction management purposes and that the value “1” 
which was received with the request is already in use. In this case the DeviceNet Router #1 is 
free to allocate an unused value (assume the value “4”) and insert it into the packet it forwards. 


Table 10-6.9 Multiple Hop Unconnected Send Request Service Data (Second Hop) 


Bytes Meaning 

04 00 The Transaction_Id field inserted by the router. 

07 Priority/Tick Time field (Time Tick = 128 ms). 

08 Connection Timeout Ticks field (8 Ticks, which results in 1024 ms timeout, 512 ms less 
than was originally received). 

11 00 Message_Size field = 17 bytes. 

10 Service field = Set_Attribute_Single. 

03 Request_Path_Size field indicates that there are 3 words in the request path. 

ae O01 24 02 30 | Request_Path field specifying 8 bit Class Id = 1, 8 bit Instance ID = 2, 8 bit Attribute Id = 3. 

01 02 03 04 O5 | Request_Data field specifying the attribute data associated with the Set_Attribute_Single 

06 O07 08 09 request. 

00 Pad byte. 

01 Route_Size field indicates that there is 1 word in the Route_Path. 

00 Reserved byte. 

04 06 Route_Path indicating that the request is to be delivered out Port #4 to the Target Device at 
MAC ID 6. Note that DeviceNet Router #1 has stripped its routing information from the 
packet. 


Step 3 — Request delivered to Remote Target Device 


When DeviceNet Router #2 receives this Service Data field in the Unconnected Send Request 
it behaves identical to the DeviceNet Router in the first example. Specifically, DeviceNet 
Router #2 executes the following steps: 


e Executes the timing related logic associated with the Priority/Tick Time and Connection 
Timeout Ticks fields. If a timeout is detected, then a successful Unconnected Send response 
that specifies a Routing Error is returned to the Requesting Device. 

e Since there is no additional path routing, the device at MAC ID 6 is the Remote Target 
Device. The DeviceNet Router establishes an Explicit Messaging Connection with that 
device (if necessary), extracts the actual transaction from the Message Request portion of 
the Service Data, and delivers the Explicit Messaging Request to the Target Device. 


The response returns back to the Requesting Device with each DeviceNet Router utilizing the 
Transaction_Id field to facilitate internal transaction management. If an error was detected at 
any point in the process, then the appropriate error information would be returned in the 
successful Unconnected Send Response. 


— 10-14 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 10: Bridging and Routing 


10-6.3 


Using the Forward Open Service to Open an I/O Messaging 


Connection 


Assume that the Requesting Device wants to make an I/O connection to an I/O Assembly. This 
data for this Assembly is identified as Class #4/Instance #2/Attribute ID #3 in the Target 
Device. 


Figure 10-6.10 Forward Open to Establish I/O Connection 


MAC ID=5 


Requesting 
Device 


Forward Opert to Class #4/Instance #2/A 


DeviceNet to EtherNet/IP Router 


Port ID = 2 Port ID =3 


IP Address >| IP Address =| 
130.151.137.112 


MAC ID=7 


DeviceNet EtherNet/IP 


The table below presents the contents of the Service Data field for the Forward Open request 
which is used to execute the connection establishment example noted above (all values are in 
hex). 


Table 10-6.11 Forward Open Request Service Data 


pp 
tt 


45 


FF 
oc 
FF 
00 
00 
00 
20 


20 


Byte Value 


00 


FF 
00 
FF 
01 


00 
Al 


Al 


00 


FF 


02 


00 
07 


07 


00 


FF 


03 


00 


00 


Meaning 
Priority/Tick Time field. 
Connection Timeout Ticks field. 


O_to_T Connection ID — Chosen by originating node (CAN ID 0x045 = Node 5, Group 1, Msg 
ID 1) 


T_to_O Connection ID — Chosen by target node 
Connection Serial Number 

Originator Vendor ID (Vendor ID = 65535) 

Originator Serial Number (Serial Number = 0x03020100) 
Connection Timeout Multiplier 

Reserved 

O_to_T RPI (0x7A120 = 500 ms) 

O_to_T Connection Parameters 

T_to_O RPI (0x7A120 = 500 ms) 

T_to_O Connection Parameters 

Transport Type / Trigger (Class 2 Cyclic Server) 
Connection_Path_Size field indicates that there are 14 words in the connection path. 


Contents of the Connection_Path field. This field specifies the routing/connection 
information. These bytes indicate that the request is to be delivered out Port #3 and to IP 
Address 130.151.137.105. This path encoding uses the Extended Link Address format for the 
IP address. It further indicates that the application being connected to by specifying 16 bit 
Class ID = 4, 16 bit Instance ID = 2, 8 bit Attribute ID = 3. 
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Step 1 — Request delivered to the DeviceNet to EtherNet/IP Router 


The first step in the process calls for the Requesting Device to establish an Explicit Messaging 
Connection with the DeviceNet to EtherNet/IP Router and issue the Forward Open request. The 
table below presents the entire Forward Open request. Assume that the Message Body Format 
established for the Explicit Messaging Connection is DeviceNet 8/8. 


Table 10-6.12 Forward Open Request on DeviceNet 


Bytes Meaning 
07 Frag = 0', Transaction ID = 0, Destination MACID = 7. 
54 Service = 54. In this context, this specifies the Forward Open service. 
06 Class ID of the Connection Manager Object Class. 
01 The Instance ID Field specifying instance 1 of the Connection Manager. 


01 00 pp tt OC O00 OE O5 | Forward Open Service Request Data. This is the previously described 
21 00 04 00 25 00 02 00 | Forward Open service data described above. 

30 03 09 00 13 OF 31 33 

30 2E 31 35 31 2E 31 33 

37 2E 31 30 35 00 


'_ This request would have to be fragmented on DeviceNet to deliver it to the router. DeviceNet fragmentation is 
not illustrated in this example. 


The Forward Open request has now been delivered to the DeviceNet Router via an Explicit 
Messaging Connection that exists between the Originating Device and the DeviceNet Router. 


Step 2 — Router creates a CIP Bridged connection 


Upon receipt of a Forward Open to the Connection Manager object, the router shall (if it has 
the resources available) create a CIP Bridged connection (Class Code 0x05) and place it in the 
Configuring state. The remaining attributes are set with either the value received in the service 
request or the appropriate default values. If resources are unavailable, an error response is 
returned. 


Step 3 — Router creates connection with the Target Device 


After the Connection Manager Object within the DeviceNet Router processes the Forward 
Open request it examines the contents of the Connection_Path field. In this case, the contents 
are “13 OF 31 33 30 2E 31 35 31 2E 31 33 37 2E 31 30 35 21 00 04 00 25 00 02 00 30 03 00”. 
This indicates that the next device in the hop is on Port #3 and its Node (IP) Address is 
130.151.137.105. Additionally, since there is only a single Port/Node Address pair specified in 
the Connection_Path field, the request has reached its destination network. When a DeviceNet 
Router receives a Forward Open Request that DOES NOT need to be forwarded through more 
intermediate CIP Routers, the following steps are taken: 


e The DeviceNet Router executes the timing related logic associated with the Priority/Tick 
Time and Connection Timeout Ticks fields. If a timeout is detected, then a successful 
Forward Open response that specifies a Routing Error is returned to the Requesting Device. 

e The DeviceNet Router creates an I/O connection with the Target Device. Once the I/O 
connection is created, the connection attributes are set, and the connection is applied. (Note 
that if the connection path indicates the Message Router object, then the router opens an 
Explicit Messaging connection using the UCMM.) 


— 10-16 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Chapter 10: Bridging and Routing 


In the example above, the connection path inside the Forward Open indicates an I/O connection 
to Class #4, Instance #2, Attribute #3. 


Step 4 — Router returns the Forward Open Response to the Requesting Device 


The DeviceNet Router then delivers the Forward Open Response to the original Requesting 
Device. This response will contain the actual packet rates and the connection identifiers to be 


used. 


The service data field for a Forward Open response is shown below. 


Table 10-6.13 Forward Open Response Service Data 


Byte Value 


45 00 00 00 


07 
oc 
FF 
00 
00 
00 
20 
20 
00 
00 


01 
00 
FF 
01 


00 
Al 
Al 


00 


02 


00 
07 
07 


00 


03 


00 
00 


Meaning 


O_to_T Connection ID — Chosen by originating node (CAN ID 0x045 = Node 5, Group 1, Msg 
ID 1) 


T_to_O Connection ID — Chosen by target node (CAN ID 0x107 = Node 7, Group 1, Msg ID 4) 
Connection Serial Number 

Originator Vendor ID (Vendor ID = 65535) 

Originator Serial Number (Serial Number = 0x03020100) 

Connection Timeout Multiplier 

Reserved 

O_to_T API (0x7A120 = 500 ms) 

T_to_O API (0x7A120 = 500 ms) 

Application reply size (no application reply data) 


Reserved 


Assume that the connection to the Target Device was successful. The text below presents the 
contents of the CAN Data Field associated with the Forward Open Response returned to the 


Requesting Device: 


Table 10-6.14 Forward Open Response on DeviceNet 


Bytes 


Meaning 
Frag = 0, Transaction ID = 0, Destination MAC = 7. 
Service = D4. In this context, this specifies a response to the Forward Open service. 
The General Status field. The value zero (0) indicates that there were no routing errors. 
Reserved byte. 


Forward Open Service Response Data. This is the previously described Forward Open 
service data described above. 
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10-6.4 Using the Forward Close Service to Close an I/O Messaging 
Connection 


The table below presents the contents of the Service Data field for the Forward Close request to 
delete the connection, which was established in the example above (all values are in hex). 


Table 10-6.15 Forward Close Request Service Data 


Byte Value Meaning 
pp Priority/Tick Time field. 
tt Connection Timeout Ticks field. 
OC 00 Connection Serial Number 
FF FF Originator Vendor ID (Vendor ID = 65535) 
00 01 02 03 Originator Serial Number (Serial Number = 0x03020100) 
OE Connection_Path_Size field indicates that there are 14 words in the connection path. 
00 Reserved 
13 OF 31 33 Contents of the Connection_Path field. This field specifies the routing/connection 
30 2E 31 35 information. These bytes indicate that the request is to be delivered out Port #3 and to IP 


31 2E 31 33 Address 130.151.137.105. This path encoding uses the Extended Link Address format for 
the IP address. It further indicates the application being disconnected from by specifying 
35 21 00 04 16 bit Class ID = 4, 16 bit Instance ID = 2, 8 bit Attribute ID = 3. 


Step 1 — Request delivered to the DeviceNet to EtherNet/IP Router 


The first step in the process calls for the Requesting Device to establish an Explicit Messaging 
Connection with the DeviceNet to EtherNet/IP Router (if one does not exist) and issue the 
Forward Close request. The table below presents the entire Forward Open request. Assume 
that the Message Body Format established for the Explicit Messaging Connection is DeviceNet 
8/8. 


Table 10-6.16 Forward Close Request on DeviceNet 


Bytes Meaning 
07 Frag = 0°, Transaction ID = 0, Destination MACID = 7. 
5E Service = 5E. In this context, this specifies the Forward Close service. 
06 Class ID of the Connection Manager Object Class. 
01 The Instance ID Field specifying instance 1 of the Connection Manager. 


©1 00 pp tt OC OO OE Forward Close Service Request Data. This is the previously described 
05 21 00 04 00 25 00 Forward Close service data described above. 

02 00 30 03 09 00 13 
OF 31 33 30 2E 31 35 
31 2E 31 33 37 2E 31 
30 35 00 


'_ This request would have to be fragmented to deliver it to the router. DeviceNet fragmentation is 
not illustrated in this example. 


The Forward Close request has now been delivered to the DeviceNet Router via an Explicit 
Messaging Connection that exists between the Originating Device and the DeviceNet Router. 
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Step 2 — Router deletes the CIP Bridged connection with Target 


After the Connection Manager Object within the DeviceNet Router processes the Forward 
Close request it examines the contents of the Connection_Path field. In this case, the contents 
are “13 OF 31 33 30 2E 31 35 31 2E 31 33 37 2E 31 30 35 21 00 04 00 25 00 02 00 30 03 00”. 
This indicates that the next device in the hop is on Port #3 and its Node (IP) Address is 
130.151.137.105. Additionally, since there is only a single Port/Node Address pair specified in 
the Connection_Path, the request has reached its destination network. When a DeviceNet 
Router receives a Forward Close Request that DOES NOT need to be forwarded through more 
intermediate CIP Routers, the following steps are taken: 


The DeviceNet Router executes the timing related logic associated with the Priority/Tick Time 
and Connection Timeout Ticks fields. If a timeout is detected, then a successful Forward Close 


response that specifies a Routing Error is returned to the Requesting Device. 


The DeviceNet Router deletes the I/O or Explicit Messaging connection with the Target 
Device. 


Step 3 — Router returns the Forward Close Response to the Requesting Device and 
releases internal resources 


The DeviceNet Router then delivers the Forward Close Response to the original Requesting 
Device and releases all internal resources related to the connections on both the DeviceNet and 
EtherNet/IP subnets. 


The service data field for a Forward Close response is shown below. 


Table 10-6.17 Forward Close Response Service Data 


Byte Value Meaning 
oc 00 Connection Serial Number 
FF FF Originator Vendor ID (Vendor ID = 65535) 
00 01 02 O3 | Originator Serial Number (Serial Number = 0x03020100) 
00 Application reply size (no application reply data) 
00 Reserved 


Assume that the connection to the Target Device was successful. The text below presents the 
contents of the CAN Data Field associated with the Forward Close Response returned to the 
Requesting Device: 


Table 10-6.18 Forward Close Response on DeviceNet 


Bytes Meaning 
07 Frag = 0, Transaction ID = 0, Destination MAC = 7. 
DE Service = DE. In this context, this specifies a response to the Forward Close service. 
00 The General Status field. The value zero (0) indicates that there were no routing errors. 
00 Reserved byte. 


OC 00 FF FF | Forward Close Service Response Data. This is the previously described Forward Close 


00 01 02 O3 | service data described above. 
00 00 
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Introduction 


This appendix contains information about Explicit Messaging services. The CIP Common 
Services are defined and examples illustrating the encoding of CIP Common Services are 
provided. CIP Common Services are those services whose request/response parameters and 
required behaviors are defined in this document. 


Service Definitions 


For any CIP service to be considered “fully defined,” its definition must include the following 
information: 


eA brief functional definition explaining what the service does (why an object would request 
the service) 
e Behaviors associated with the service 
e Parameters which are placed in the Service Data Field of an Explicit Request Message, 
including: 
e Data type 
e Description 
e Parameters which are placed in the Service Data Field of an Explicit Response Message, 
including: 
e Data type 
e Description 
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CIP Common Services 


The codes and names of the CIP Common Services are listed below. 


Table A-3.1 CIP Service Codes and Names 


Service Code 
(in hex) 


00 
01 
02 
03 
04 
05 
06 
07 
08 
09 
0A 
OB-0C 
0D 
OE 
OF 
10 
11 
12-13 
14 
15 
16 
17 
18 
19 
1A 
1B 
1C 
1D-31 


Service Name 


Reserved for future use 
Get_Attributes_All 
Set_Attributes_All Request 
Get_Attribute_List 
Set_Attribute_List 

Reset 

Start 

Stop 

Create 

Delete 
Multiple_Service_Packet 
Reserved for future use 
Apply_Attributes 
Get_Attribute_Single 
Reserved for future use 
Set_Attribute_Single 
Find_Next_Object_Instance 
Reserved for future use 
Error Response (used by DeviceNet only) 
Restore 

Save 

No Operation (NOP) 
Get_Member 

Set_Member 
Insert_Member 
Remove_Member 
GroupSync 

Reserved for additional Common Services 
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A-4.1 


A-4.1.1 


A-4.1.2 


CIP Common Service Definitions 


This section provides a general description of the CIP Common Services. Objects 
Classes/Instances that utilize these Services must provide a detailed description of their specific 
use. 


Get_Attributes_All - Service Code: 011, 
Returns the contents of the instance or class attributes defined in the object definition. 


Service Requirements 


The following list details requirements associated with the Get_Attributes_All service: 


1. The structure of the information in the successful response’s Service Data Field adheres to 
the Get_Attributes_All response structure defined by the object or class. Support of this 
service requires the Object and/or Class to provide a detailed definition of the format of the 
data sent in the response message. 

2. Ifthe request is successfully serviced, then a Get_Attributes_All Response is returned. The 
Service Data Field of the response contains the attribute data. If an error is detected, then 
an Error Response is returned 

3. A device is only required to include data in the response data array up to the last 
implemented attribute. 

4. Ifthe length of data in the response is less than documented in the object definition and the 
last part of the response data does not include a complete attribute, the response data is in 
error and the client shall discard it. 

5. Ifthe length of data in the response is less than documented in the object definition, the 
client assumes default values for the missing attributes. 

6. If the length of data in the response is greater than the expected amount, the client ignores 
any data in excess of what was expected. 


Important: Insert default values for all unsupported attributes present in the response byte 
array. 


Important: Insert a zero count and no array elements for attributes that specify a count of array 
elements in another attribute, if the attribute pair is not supported. An example of this type of 
attribute is the Discrete Input Point Object (class code O8hex), instance attribute 1, Number of 
Attributes. 


Important: Insert a zero count for attributes that specify a count followed by an array of 
entries, if the attribute is not supported. An example of this type of attribute is class attribute 4, 
Optional attribute list. 


Refer to Volume 1, Chapter 4 for rules for how the Get_Attributes_All response data is 
defined. 


Request Service Data Field Parameters 


None. 
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A-4.1.3 Success Response Service Data Field Parameters 


The following information is specified within the Service Data Field of a successful response to 
a Get_Attributes_All request 


Table A-4.1 Service Data for Set_Attributes_All Success Response 


Name Data Type Description of Parameter 


Attribute Data | Object/class attribute— | A stream of information containing all of the attributes. Classes/Objects 
specific Struct which support this service must define the format of this parameter. 
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A-4.2 


A-4.2.1 


A-4.2.2 


A-4.2.3 


Set_Attributes_All - Service Code: 02;;,, 
Modifies the contents of the instance or class attributes defined in the object definition. 


Service Requirements 


The following list details requirements associated with the Set_Attributes_All service: 


1. The structure of the information in the request’s Service Data Field adheres to the 
definition of the Set_Attributes_All request for the object or class. Support of this service 
requires the Object and/or Class to provide a detailed definition of the format of the data 
sent in the request message. 

2. If the ability to modify an attribute changes based on the state of the object, the object 
definition must provide a detailed description of how this service is affected. For example, 
this service could only be supported in a state where all attributes are modifiable. 

3. Attributes will be modified only if all attribute specific value verifications (e.g. range 
checks, etc.) are successful. The first attribute failing verification will be specified in the 
Additional Code parameter of the Error Response message. 

4. If any other error is detected, then an Error Response is returned. 

5. If all verification checks pass, then the attributes are modified and a Set_Attributes_All 
success response is returned. 

6. Ifthe length of data in the service is less than documented in the object definition and the 
last part of the response data does not include a complete attribute, the “Not enough data” 
(0x13) Error Response is returned. 

7. Ifthe length of data in the service data field is less than documented in the object 
definition, this indicates the attributes represented by the missing data are not supported by 
the client. Missing data shall result in no modification to the corresponding attributes. 

8. If the length of data in the request is greater than the expected amount, the “Too much 
data” (0x15) Error Response is returned. 

9. The Set_Attributes_All service can be supported by an object only if all settable attributes 
shown in the Set_Attributes_All request byte array are implemented and settable. The 
“Attribute Not Supported” (0x14) is the required error code. 


Refer to Chapter 4 for rules how the Set_Attributes_All service data is defined. 
Request Service Data Field Parameters 


The following information is specified within the Service Data Field of a Set_Attributes_All 
request. 


Table A-4.2 Service Data for Set_Attributes_All Request 


Name Description of Parameter 


Attribute Data | Object/class attribute— | A stream of information containing all of the attributes. 
specific Struct Classes/Objects which support this service must define the format of 
this parameter. 


Success Response Service Data Field Parameters 


None. 
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A-4.3 


A-4.3.1 


A-4.3.2 


A-4.3.3 


Get_Attribute_List - Service Code: 03,;,, 


The Get_Attribute_List service shall return the contents of the selected gettable attributes of the 
specified object class or instance. 


Service Requirements 


The following list details requirements associated with the Get_Attribute_List service: 


1. The attributes shall be specified using a list of attribute identifiers. 

2. The number of attributes actually returned shall be reported within the response. If there is 
not enough space for an attribute’s data in the response message, a partial response shall be 
returned. 

3. Attribute data returned within partial response messages shall be complete. The client 
application can submit another Get_Attribute_List service request for the attribute data 
remaining from its original list. 

4. The client application shall verify the value of the attribute count parameter in the 
response. 

5. Status shall be reported with each individual attribute. Attribute data shall be retrieved and 
packed in the sequence specified in the request. 

6. When “Attribute Status” is a value other than “Success” (0x00), the “Attribute Data” shall 
not be returned. 


Request Service Data Field Parameters 


The following information is specified within the Service Data Field of a Get_Attribute_List 
request. 


Table A-4.3 Service Data for Get_Attribute_List Request 


Name Data Type Description of Parameter 
Attribute_count | UINT Number of attribute identifiers in the attribute list 


Attribute_list ARRAY of UINT List of the attribute identifiers to get from the class or object 


Success Response Service Data Field Parameters 


The following information is specified within the Service Data Field of a successful 
Get_Attribute_List response. 


Table A-4.4 Service Data for Get_Attribute_List Success Response 


Name Data Type Description of Parameter 
Attribute_count |UINT Number of “Attribute response structures” returned 


Attribute response | LIST of STRUCT: A list of response structures 
structures 


UINT “Attribute identifier”, the number of the attribute identifier being 
returned 


UINT “Attribute Status”, the status of the attribute response (per appendix B) 


Object/Class specific | “Attribute Data”, Attribute response data - exists when “Attribute 
attribute data Status” is the value “Success” (0x00). 
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A-4.4 


A-4.4.1 


A-4.4.2 


A-4.4.3 


Set_Attribute_List - Service Code: 04;;,, 


The Set_Attribute_List service shall set the contents of selected attributes of the specified 
object class or instance. 


Service Requirements 


The following list details requirements associated with the Set_Attribute_List service: 


1. The data for each individual attribute shall be placed into the request in its entirety. 

2. Each set activity shall be performed in the order specified in the list. 

3. Status shall be reported for each of the individual attributes in the response. 

4. A server shall not attempt to set an attribute for which it can not return a response status. 


Request Service Data Field Parameters 


The service data field of the Set_Attribute_List request shall be as specified in the following 
table. 


Table A-4.5 Service Data for Set_Attribute_List Request 


Name Data Type Description of Parameter 
Attribute_count | UINT Number of attribute identifiers in the attribute list 


Attributes request | LIST of STRUCT: List of structures specific to this service 
structures 


UINT “Attribute Identifier” - Attribute identification number 
Object / class specific data Related attribute data 


Success Response Service Data Field Parameters 


The following information is specified within the Service Data Field of a successful 
Set_Attribute_List response. 


Table A-4.6 Service Data for Set_Attribute_List Response 


Name Description of Parameter 
Attribute_count | UINT Number of attribute values being returned 


Attribute response | LIST of A list of response structures 
structures STRUCT: 


UINT “Attribute identifier”, the number of the attribute identifier being returned 
UINT “Attribute Status”, the status of the attribute response (per appendix B) 


Object/Class “Attribute Data”, Attribute response data - may exist when “Attribute 
specific attribute | Status” is the value “Success” (0x00). 
data 
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A-4.5 


A-4.5.1 


A-4.5.2 


A-4.5.3 


Reset - Service Code: 05,,, 


Invokes the Reset service of the specified Class/Object. Typically this would cause a transition 
to a default state or mode. 


Service Requirements 


The following list details requirements associated with the Reset service: 


1. Ifthe execution of the Reset service request would place the object/device in a state that 
will enable it to respond to the requester, then the response is not returned until the service 
has completed. If the execution of the Reset service would place the object/device in a state 
in which it may not be able to respond, the object/device must respond prior to executing 
the Reset service. 

2. If an error is detected, then an Error Response is returned. Otherwise, a successful Reset 
response is returned. 


Request Service Data Field Parameters 


The following information is OPTIONALLY specified within the Service Data Field of a 
Reset request. 


Table A-4.7 Service Data for Reset Request 


Name Data Type Description of Parameter 


Object Contains Class/Instance specific parameters. If a Class/Instance utilizes 


Object/class service— 
Specific Data | specific STRUCT this field, then the Class/Instance definition must specify its format. 


Success Response Service Data Field Parameters 


The following information is OPTIONALLY specified within the Service Data Field of a 
successful response to a Reset request 


Table A-4.8 Service Data for Reset Success Response 


Name Data Type Description of Parameter 


Object Contains Class/Instance specific parameters. If a Class/Instance utilizes 


Object/class service— 
Specific Data | specific STRUCT this field, then the Class/Instance definition must specify its format. 
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A-4.6 


A-4.6.1 


A-4.6.2 


A-4.6.3 


Start - Service Code: 06,,, 


Invokes the Start service of the specified Class/Object. Typically, this would place an object 
into a running state/mode. 


Service Requirements 


The following list details requirements associated with the Start service: 


1. Other than documenting the state machine associated with the object/class relative to this 
service, there are no special requirements defined by CIP. 

2. If an error is detected, then an Error Response is returned. Otherwise, a successful Start 
response is returned. 


Request Service Data Field Parameters 


The following information is OPTIONALLY specified within the Service Data Field of a Start 
request. 


Table A-4.9 Service Data for Start Request 


Name Description of Parameter 


Object Contains Class/Instance specific parameters. If a Class/Instance utilizes 


Object/class service— 
Specific Data | specific STRUCT this field, then the Class/Instance definition must specify its format. 


Success Response Service Data Field Parameters 


The following information is OPTIONALLY specified within the Service Data Field of a 
successful response to a Start request 


Table A-4.10 Service Data for Start Success Response 


Name Description of Parameter 


Object Contains Class/Instance specific parameters. If a Class/Instance utilizes 


Object/class service— 
Specific Data | specific STRUCT this field, then the Class/Instance definition must specify its format. 
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A-4.7 


A-4.7.1 


A-4.7.2 


A-4.7.3 


Stop - Service Code: 07 ¢x 


Invokes the Stop service of the specified Class/Object. Typically, this would place an object 
into a stopped or idle state/mode. 


Service Requirements 


The following list details requirements associated with the Stop service: 


1. Other than documenting the state machine associated with the object/class relative to this 
service, there are no special requirements defined by CIP. 

2. If an error is detected, then an Error Response is returned. Otherwise, a successful Stop 
response is returned. 


Request Service Data Field Parameters 


The following information is OPTIONALLY specified within the Service Data Field of a Stop 
request. 


Table A-4.11 Service Data for Stop Request 


Name Description of Parameter 


Object Contains Class/Instance specific parameters. If a Class/Instance utilizes 


Object/class service— 
Specific Data | specific STRUCT this field, then the Class/Instance definition must specify its format. 


Success Response Service Data Field Parameters 


The following information is OPTIONALLY specified within the Service Data Field of a 
successful response to a Stop request 


Table A-4.12 Service Data for Stop Success Response 


Name Description of Parameter 


Object Contains Class/Instance specific parameters. If a Class/Instance utilizes 


Object/class service— 
Specific Data | specific STRUCT this field, then the Class/Instance definition must specify its format. 
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A-4.8 


A-4.8.1 


A-4.8.2 


A-4.8.3 


Create - Service Code: 08, 
Results in the instantiation of a new object within the specified class. 


Service Requirements 


The following list details requirements associated with the Create service: 


1. The object instance is created and initialized in accordance with the object definition. 

2. Any error will result in the object instance not being created. 

3. If an error is detected, then an Error Response is returned. Otherwise, a successful Create 
response is returned. 


Request Service Data Field Parameters 


The following information is OPTIONALLY specified within the Service Data Field of a 
Create request. 


Table A-4.13 Service Data for Create Request 


Name Description of Parameter 


Object Object/class service— | Contains Class/Instance specific parameters. If a Class/Instance utilizes 
Specific Data | specific STRUCT this field, then the Class/Instance definition must specify its format. 


Success Response Service Data Field Parameters 


The following information is specified within the Service Data Field of a successful response to 
a Create request 


Table A-4.14 Service Data for Create Success Response 


Name Description of Parameter 


Instance ID UINT The integer value assigned to identify the newly created object. This is 
specified within a 16-bit field regardless of the Message Body Format 
associated with the Explicit Messaging Connection. 

Object Object/class service— | Contains Class/Instance specific parameters. If a Class/Instance utilizes 


Specific Data | specific STRUCT this field, then the Class/Instance definition must specify its format. 
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A-4.9 Delete - Service Code: 09;;,, 
Deletes an object instance of the specified class. 


A-4.9.1 Service Requirements 


The following list details requirements associated with the Delete service: 


1. All resources are deallocated and returned to the system. 
2. If an error is detected, then an Error Response is returned. Otherwise, a successful Delete 
response is returned. 


A-4.9.2 | Request Service Data Field Parameters 


The following information is OPTIONALLY specified within the Service Data Field of a 
Delete request. 


Table A-4.15 Service Data for Delete Request 


Name Description of Parameter 


Object Contains Class/Instance specific parameters. If a Class/Instance utilizes 


Object/class service— 
Specific Data | specific STRUCT this field, then the Class/Instance definition must specify its format. 


A-4.9.3 Success Response Service Data Field Parameters 


The following information is OPTIONALLY specified within the Service Data Field of a 
successful response to a Delete request 


Table A-4.16 Service Data for Delete Success Response 


Name Data Type Description of Parameter 


Object Contains Class/Instance specific parameters. If a Class/Instance utilizes 


Object/class service— 
Specific Data | specific STRUCT this field, then the Class/Instance definition must specify its format. 
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A-4.10 


A-4.10.1 


A-4.10.2 


Multiple_Service_Packet - Service Code: 0A}, 
Performs a set of services as an autonomous sequence. 


Service Requirements 


The following list details requirements associated with the Multiple_Service_Packet service: 


Performs services as an autonomous sequence of services. 

Performs services in the sequence supplied. 

Performs all services, reporting individual responses for each one. 

Packs responses into the response buffer in the sequence in which they were executed. 

A response timeout must be implemented for those service requests that do not guarantee a 
response. 

6. Each embedded service may return a success or failure, as indicted in the response 
structure. If one or more service requests result in an error this service shall return an error. 
The error code returned shall be 1Ehex (Embedded service error). 


Ww PWN PE 


This service allows clients to submit a sequence of ‘embedded’ services in a single message 
packet. The object processing the Multiple_Service_Packet shall not perform any other service 
until the entire sequence of embedded services has been attempted. 


The embedded services are formatted according to their definitions. Each embedded service 
may contain an EPATH. If an EPATH is present, the embedded service is passed to the 
Message Router for processing. If an EPATH is not present, the object performing the 
Multiple_Service_Packet request shall perform the embedded service. 


Request Service Data Field Parameters 


The following information is specified within the Service Data Field of a 
Multiple_Service_Packet request. 


Table A-4.17 Service Data for Multiple_Service_Packet Request 


Name Data Type Description of Parameter 
Number of UINT Number of embedded services in the Service List. 
Services 


Service Offsets | ARRAY of Array of byte offsets to the start of each embedded service in the Service List. 
UINT 


Service List ARRAY of Array of service request structures. The format of the service request follows 
STRUCT of the Message Router Request header defined in Chapter 2. 


USINT Service code of the request. 
USINT The number of 16 bit words in the Request_Path field (next element). 


Padded This is an array of bytes whose contents convey the path of the request (Class 
EPATH ID, Instance ID, etc.) for this transaction. 


ARRAY of Service specific data to be delivered in the Explicit Messaging Request. If no 
octet additional data is to be sent with the Explicit Messaging Request, then this 
array will be empty. 
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A-4.10.3 


Success Response Service Data Field Parameters 


The following information is specified within the Service Data Field of a successful response to 
a Multiple_Service_Packet request 


Table A-4.18 Service Data for Multiple_Service_Packet Response 


Name Description of Parameter 
Number of UINT Number of embedded services responses in the Response List. 
Responses 
Response Offsets | ARRAY of Array of byte offsets to the start of each embedded service response in 
UINT the Response List. 
Response List ARRAY of Array of service response structures. The format of the service 


STRUCT of response follows the Message Router Response header defined in 
Chapter 2. 


USINT Reply service code. 
USINT Shall be zero. 
USINT One of the General Status codes listed in Appendix B (Status Codes). 
USINT Number of 16 bit words in Additional Status array. 
ARRAY of Additional status. 
UINT 


ARRAY of Response data from request or additional error data if General Status 
octet indicated an error. 
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A-4.11  Apply_Attributes - Service Code: 0D» x 


Causes attribute values whose use is pending to become actively used. 


A-4.11.1 Service Requirements 


The following list details requirements associated with the Apply_Attributes service: 


1. Data for pending attributes must be verified before it is actually used. 
2. If an error is detected, then an Error Response is returned. Otherwise, a successful 
Apply_Attributes response is returned. 


A-4.11.2 Request Service Data Field Parameters 


The following information is OPTIONALLY specified within the Service Data Field of an 
Apply_Attributes request. 


Table A-4.19 Service Data for Apply_Attributes Request 


Name Description of Parameter 
Object Specific | Object/class service— | Contains Class/Instance specific parameters. If a Class/Instance utilizes 
Data specific STRUCT this field, then the Class/Instance definition must specify its format. 


A-4.11.3. Success Response Service Data Field Parameters 


The following information is OPTIONALLY specified within the Service Data Field of a 
successful response to an Apply_ Attributes request 


Table A-4.20 Service Data for Apply_Attributes Success Response 


Name Data Type Description of Parameter 


Object Specific | Object/class service— | Contains Class/Instance specific parameters. If a Class/Instance utilizes 
Data specific STRUCT this field, then the Class/Instance definition must specify its format. 
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A-4.12 


A-4.12.1 


A-4.12.2 


A-4.12.3 


Get_Attribute_Single - Service Code: 0E,., 
Returns the contents of the specified attribute. 


Service Requirements 


The following list details requirements associated with the Get_Attribute_Single service: 


1. The service causes the class/object to return the contents of the specified attribute to the 
requester. 

2. If an error is detected, then an Error Response is returned. Otherwise, a successful 
Get_Attribute_Single response is returned along with the requested attribute data. 


Request Service Data Field Parameters 


The following information is specified within the Service Data Field of a Get_Attribute_Single 
request. 


Table A-4.21 Service Data for Get_Attribute_Single Request 


Name Description of Parameter 


Attribute ID! Identifies the attribute to be read/returned 


This parameter shall be present when the target of the request is on a subnet, which does not support explicit 
message addressing to the attribute level. If the subnet does support attribute level addressing then this parameter 
shall not be present. In the latter case, the data type of the Attribute ID can be either USINT, UINT, or UDINT. 


Success Response Service Data Field Parameters 


The following information is specified within the Service Data Field of a successful 
Get_Attribute_Single response. 


Table A-4.22 Service Data for Get_Attribute_Single Success Response 


Name Data Type Description of Parameter 
Attribute Data Object/class attribute specific Struct Contains the requested attribute data 
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A-4.13 


A-4.13.1 


A-4.13.2 


A-4.13.3 


Set_Attribute_Single - Service Code: 104. x 
Modifies an attribute value. 


Service Requirements 


The following list details requirements associated with the Set_Attribute_Single service: 


1. The attribute data is validated prior to the modification taking place. 
2. If an error is detected, then an Error Response is returned. Otherwise a successful 
Set_Attribute_Single response is returned. 


Request Service Data Field Parameters 


The following information is specified within the Service Data Field of a Set_Attribute_Single 
request. 


Table A-4.23 Service Data for Set_Attribute_Single Request 


Name Description of Parameter 
Attribute ID' | USINT Identifies the attribute to be read/returned 


Attribute Data | Attribute specific Contains the value to which the specified attribute is to be modified. 


' This parameter shall be present when the target of the request is on a subnet, which does not support explicit 
message addressing to the attribute level. If the subnet does support attribute level addressing then this parameter 
shall not be present. In the latter case, the data type of the Attribute ID can be either USINT, UINT, or UDINT. 


Success Response Service Data Field Parameters 


The following information is OPTIONALLY specified within the Service Data Field of a 
successful response to a Set_Attribute_Single request 


Table A-4.24 Service Data for Set_Attribute_Single Success Response 


Name Data Type Description of Parameter 


Object Data | Object/class service— | Contains Class/Instance specific parameters. If a Class/Instance utilizes 
specific STRUCT this field, then the Class/Instance definition must specify its format. 
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A-4.14 Find_Next_Object_Instance - Service Code: 11}. 


This service is supported at the Class level only. It causes the specified Class to search for and 
return a list of Instance IDs associated with existing Object Instances. Existing Objects are 
those that are currently accessible from the CIP subnet. 


A-4.14.1 Service Requirements 


The following list details requirements associated with the Find_Next_Object_Instance service: 


1. The Class utilizes the value specified in the Instance ID of the request message to 
determine the starting point for the search as described below: 

e If the Instance ID in the request message is zero (0), then the Class starts with the 
numerically lowest Instance ID. 

e If the Instance ID in the request message is not zero (0), then the Class starts with the 
next Instance ID whose value is numerically greater than the specified Instance ID. 

e If the Instance ID in the request message is greater than or equal to the numerically 
highest Instance ID within the Class, then the value zero (0) is returned. 

2. The Class returns a list of Instance IDs associated with existing Objects beginning at the 
starting point and continuing in ascending Instance ID value order. 

3. The request specifies the maximum number of Instance ID values to be returned in the 
response. The responding Class can return any number of Instance IDs less than or equal 
to the maximum specified in the request. 

4. The responding device returns Instance ID value zero (0) to indicate that the end of the list 
has been reached. 

5. If an error is detected, then an Error Response is returned. Otherwise, a successful 
Find_Next_Object_Instance response is returned. 


The following illustration provides a general example of this service. Specific encoding 
examples are presented in section A-6. 


Figure A-4.25 Example of Find_Next_Object_Instance Message Flow 


Find_Next_Object_Instance Request, [Instance ID = 0] Class A 


— TT 
Find_Next_Object_Instance Response, Service Data = 1 Instance Instance 
st 
ID #1 ID #8 
Find_Next_Object_Instance Request, [Instance ID = 2] 
Se 


Find_Next_Object_Instance Response, Service Data = 5, 8 
Se 
Instance Instance 
Find_Next_Object_Instance Request, [Instance ID = 8] ID #9 ID #5 
— OC eer —?nan— aaa 
Find_Next_Object_Instance Response, Service Data = 9, 0 
SS ee n— 
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A-4.14.2 


A-4.14.3 


Request Service Data Field Parameters 


The following information is specified within the Service Data Field of a 
Find_Next_Object_Instance request. 


Table A-4.26 Service Data for Find_Next_Object_Instance Request 


Name Description of Parameter 
Maximum Returned 


Values 


Indicates the maximum number of Instance ID values to be returned in 
the response message. 


Success Response Service Data Field Parameters 


The following information is specified within the Service Data Field of a successful 
Find_Next_Object_Instance response. 


Table A-4.27 Service Data for Find_Next_Object_Instance Success Response 


Name Description of Parameter 
Number Of List Contains the number of Instance IDs specified in this response message. 
Members 
Instance ID List Array of UINT | Contains the returned Instance ID List. The Instance IDs are returned in 


16 bit integer fields. 
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A-4.15 


A-4.15.1 


A-4.15.2 


A-4.15.3 


Restore - Service Code: 154.x 


Restores the contents of a class/object’s attributes from a storage location accessible by the 
Save service. Attribute data is copied from a storage area to the currently active memory area 
used by the class/object. 


Service Requirements 


The following list details requirements associated with the Restore service: 


1. Attribute data must be verified before the copy from the “storage area” to the “actively 
used” area is performed. 

2. If the ability to modify an attribute changes based on the state of the object, the object 
definition must provide a detailed description of how this service is effected. For example; 
this service could only be supported in a state where all attributes are modifiable. 
Alternatively, the object could ignore the data associated with a currently non-modifiable 
attribute. 

3. Attributes will be modified only if all attribute specific value verifications (e.g. range 
checks, etc.) are successful. The first attribute failing verification will be specified in the 
Additional Code parameter of the Error Response message. 

4. If any other error is detected, then an Error Response is returned. 

5. If all verification checks pass, then the attributes are modified and a Restore success 
response is returned. 


Request Service Data Field Parameters 


The following information is OPTIONALLY specified within the Service Data Field of a 
Restore request. 


Table A-4.28 Service Data for Restore Request 


Name Data Type Description of Parameter 


Object Specific | Object/class service— _| Contains Class/Instance specific parameters. If a Class/Instance utilizes 
Data specific STRUCT this field, then the Class/Instance definition must specify its format. 


Success Response Service Data Field Parameters 


The following information is OPTIONALLY specified within the Service Data Field of a 
successful response to a Restore request 


Table A-4.29 Service Data for Restore Success Response 


Name Data Type Description of Parameter 


Object Specific | Object/class service— | Contains Class/Instance specific parameters. If a Class/Instance utilizes 
Data specific STRUCT this field, then the Class/Instance definition must specify its format. 
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A-4.16 


A-4.16.1 


A-4.16.2 


A-4.16.3 


Save - Service Code: 164.x 


Copies the contents of an class/object’s attributes to a location accessible by the Restore 
service. 


Service Requirements 


The following list details requirements associated with the Save service: 


1. The service will report success only after the copy has been completed and verified. 
2. If an error is detected, then an Error Response is returned. Otherwise, a successful Save 
response is returned. 


Request Service Data Field Parameters 


The following information is OPTIONALLY specified within the Service Data Field of a Save 
request. 


Table A-4.30 Service Data for Save Request 


Name Description of Parameter 
Object Specific | Object/class service— | Contains Class/Instance specific parameters. If a Class/Instance utilizes 
Data specific STRUCT this field, then the Class/Instance definition must specify its format. 


Success Response Service Data Field Parameters 


The following information is OPTIONALLY specified within the Service Data Field of a 
successful response to a Save request 


Table A-4.31 Service Data for Save Success Response 


Name Data Type Description of Parameter 


Object Specific | Object/class service— | Contains Class/Instance specific parameters. If a Class/Instance utilizes 
Data specific STRUCT this field, then the Class/Instance definition must specify its format. 
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A-4.17 


A-4.17.1 


A-4.17.2 


A-4.17.3 


No Operation (NOP) - Service Code: 17}. 


This service merely causes the receiving object to return a No Operation response. The 
receiving object does not carry out any other internal action. This service can be used to test 
whether or not a particular object is still present and responding without causing a state change. 


Required Behavior 


The NOP service requires the following behaviors: 


1. If the object to which the request is delivered supports the service, then a response whose 
status indicates success is returned. If the object does not support the service, then a 
response indicating an error was detected is returned. 


Request Service Data Field Parameters 


NONE 


Success Response Service Data Field Parameters 


NONE 
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A-4.18 


A-4.18.1 


A-4.18.2 


A-4.18.3 


Get_Member - Service Code: 18}. 


Returns member(s) information from within an attribute. See Section A-5 for Member Service 
Protocol details. 


Service Requirements 


The following list details requirements associated with the Get_Member service: 


1. The service causes the class/object to return member(s) at the specified Member ID of an 
attribute. 

2. If an error is detected, then an Error Response is returned. Otherwise, a successful 
Get_Member response is returned. 

3. If Member ID is greater than largest existing Member ID, gets the one member with the 
highest Member ID. 

4. Ifthe Member ID value is zero, returns an Invalid Member ID Error Response. To get all 
members, use a Get_Attribute_Single service. 


Request Service Data Field Parameters 
Table A-4.32 Service Data for Get_Member Request 


Request Field Required/Optional/Not Present 
Member Data Not present 


Success Response Service Data Field Parameters 


Table A-4.33 Service Data for Get_Member Response 


Response Field Required/Optional/Not Present 
Member ID Required 
Member Data Required 
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Set_Member - Service Code: 19}, 


Sets member(s) information in an attribute. See Section A-5 for Member Service Protocol 
details. 


Service Requirements 


The following list details requirements associated with the Set_Member service: 


1. The service causes the class/object to set member(s) at the specified Member ID of an 
attribute. 

2. The request is checked, and if valid, the member(s) are set to the new Member Data. 

3. If an error is detected, then an Error Response is returned. Otherwise, a successful 
Set_Member response is returned. 

4. Ifthe Member ID value is greater than that of the last Member ID for the specific attribute, 
no action occurs and an Invalid Member ID Error Response is returned. 

5. If multiple members are specified and fewer members exist at the specified Member ID, no 
action occurs and an Invalid Member ID Error Response is returned. 

6. Ifthe Member ID value is zero, an Invalid Member ID Error Response is returned. 


Request Service Data Field Parameters 


Table A-4.34 Service Data for Set_Member Request 


Request Field Required/Optional/Not Present 
Member Data Required 


Success Response Service Data Field Parameters 


Table A-4.35 Service Data for Set_Member Response 


Response Field 
Member ID 


Required/Optional/Not Present 
Conditional 
(Required if Member Data is present) 


Member Data Optional 
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Insert_Member - Service Code: 1A}, 
Inserts member(s) into an attribute. See Section A-5 for Member Service Protocol details. 


Service Requirements 


The following list details requirements associated with the Insert_Member service: 


1. The service causes the class/object to insert member(s) at the specified Member ID of an 
attribute. The Member IDs of members at or following the specified Member ID will 
change. 

2. The request is checked, and if valid, the member(s) are inserted. If member data is not 
included in the request, the member(s) are set to the class/attribute specific default. 

3. If an error is detected, then no action is taken and an Error Response is returned. 
Otherwise, a successful Insert_Member response is returned. 

4. Ifthe number of members specified cannot be added to the attribute, then a “Resource 
unavailable” error response is returned. 

5. Ifthe Member ID value is greater than that of the last Member ID for the specific attribute, 
appends member(s) to the attribute and returns the Member ID where inserted. 

6. Ifthe Member ID value is zero, returns an Invalid Member ID Error Response. 


Request Service Data Field Parameters 
Table A-4.36 Service Data for Insert_Member Request 


Request Field Required/Optional/Not Present 
Member Data Optional 


Success Response Service Data Field Parameters 


Table A-4.37 Service Data for Insert_Member Request 


Response Field Required/Optional/Not Present 
Member ID Required 
Member Data Optional 
— A-29 - 
Edition 3.3 


ODVA & ControlNet International, Ltd. 


Volume 1: 


Common Industrial Protocol Specification, Appendix A: Explicit Messaqing Services 


A-4.21 


A-4.21.1 


A-4.21.2 


A-4.21.3 


Remove_Member - Service Code: 1By,., 


Removes member(s) from an attribute. See Section A-4.22 for Member Service Protocol 
details. 


Service Requirements 


The following list details requirements associated with the Remove_Member service: 


1. The service causes the class/object to remove member(s) at the specified Member ID of an 
attribute. The Member IDs of members following the removed member(s) change. 

2. If an error is detected, then no action is taken and an Error Response is returned. 
Otherwise, a successful Remove_Member response is returned. 

3. If Member ID is greater than largest existing Member ID, the one member with the highest 
Member ID is removed. 

4. If multiple members are specified and fewer members exist at the specified Member ID, the 
member(s) that do exist are removed. 


Request Service Data Field Parameters 
Table A-4.38 Service Data for Remove_Member Request 


Request Field Required/Optional/Not Present 
Member Data Not present 


Success Response Service Data Field Parameters 


Table A-4.39 Service Data for Remove_Member Response 


Response Field Required/Optional/Not Present 
Member ID Required 
Member Data Required 
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A-4.22  GroupSync - Service Code: 1Cy,x 
Verify each member of a group is synchronized to System Time. 


A-4.22.1 Service Requirements 


The following list details requirements associated with the GroupSync service: 


1. The structure of the information in the request’s Service Data Field adheres to the 
definition of the GroupSync request for the object or class. Support of this service requires 
the Object and/or Class to provide a detailed definition of the format of the data sent in the 
request message. 


2. The structure of the information in the response’s Service Data Field adheres to the 
definition of the GroupSync response for the object or class. Support of this service 
requires the Object and/or Class to provide a detailed definition of the format of the data 
sent in the response message. 


3. The responder will verify that the application is synchronized according to the obect 
specific requirements. The target return’s a 1 in the IsSynchronized attribute of the 
response Service Data Field if the synchronized status is true and a 0 if the synchronized 
status is false. 


Refer to the GroupSync section of the CIP Sync Overview in the Time Sync Object for a more 
detailed description of the GroupSync service. 


A-4.22.2 Request Service Data Field Parameters 


The following information is specified within the Service Data Field of a GroupSync request. 


Table A-4.40 Service Data for GroupSync Request 


Name Description of Parameter 


Object specific parameters Object specific Object specific 


A-4.22.3. Response Service Data Field Parameters 


The following information is specified within the Service Data Field of a GroupSync response. 


Table A-4.41 Service Data for GroupSync Success Response 


Name Data Type Description of Semantics of values 
Parameter 


IsSynchronized BOOL Indicates if object is 1 = Is Synchronized 
synchronized to the 0 = Not Synchronized 
PTP Time Master 

Object specific parameters Object specific Object specific 
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A-5 


A-5.1 


Member Service Protocols 


Attributes of object classes may consist of arrays of basic data types or structures. To 
manipulate members of an array, the following member services use the protocols defined in 
this section: 


e Get Member 

e Set _Member 

e  Insert_Member 

e Remove_Member 


The first member in an array is specified by a Member ID value of one (1). 


Member ID/EX Description 


Two message formats are defined for member services: basic and extended. Within the 
extended format, there exist up to 255 protocol options. The message format is selected by the 
most significant bit of the Member ID. When a subnet does not support Attribute and Member 
level addressing, the Member ID/EX parameter is sent as a 16 bit (WORD) parameter within 
the service data. If the subnet does support Attribute and Member level addressing, the 
Member ID/EX parameter is sent within the Logical Segment and can be either 8, 16, or 32 bits 
(BYTE, WORD, DWORD). The following table defines the bits contained within the Member 
ID/EX field when sent as a WORD. 


Table A-5.1 Member ID/EX Description (WORD) 


Bits 


eo a Pee eee 


Member ID Bits 0-7 


EX Member ID Bits 8-14 


The lower fifteen bits (0-14) of the Member ID/EX field identify the member to be 
manipulated. Bit 15 (EX), selects either the basic (EX=0) or extended (EX=1) message format. 
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Member Request Message - Basic 
The following table illustrates the basic Member Request Message service data format. 


Table A-5.2 Service Data for Basic Format Member Request Messages 


Name Description of Parameter 


Attribute ID! | USINT Identifies the attribute the member is to be serviced. 


The lower 15 bits identifies the Member ID identifies attribute of the 


Member ID/ | WORD new member to be serviced. If the value is zero (0) the service used 
2 


EX determines the behavior. 
Extended Protocol Option EX = 0 (Bit 15) 
Member | Member This field is required by some services, see individual service 
Data specific descriptions. 
(conditional) 


This parameter shall be present when the target of the request is on a subnet which does not support 
explicit message addressing to the attribute level. If the subnet does support attribute level addressing 
then this parameter shall not be present. In the latter case, the data type of the Attribute ID can be 
either USINT, UINT, or UDINT. 


? This parameter shall be present when the target of the request is on a subnet, which does not support 
explicit message addressing to the member or attribute level. If the subnet does support attribute and 
member level addressing then this parameter shall not be present. In this latter case, the data type of the 
Member ID/EX can be either BYTE, WORD, or DWORD with the most significant bit being the 
Extended Protocol Option parameter and the remaining bits being the Member ID. 


Table A-5.3 Service Data for Basic Format Member Response Messages 


Name Description of Parameter 
Member ID The Member ID of the member serviced. 

(conditional) This field is required by some services, see 
individual service descriptions. This field is 
required if the Member Data field is present. 

Member Data | Member specific This field is required by some services, see 

i individual service descriptions. 
(conditional) 
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A-5.3 


Member Request Message - Extended 


If the Extended protocol bit [EX] of the Member ID/EX field is set to a one [1], the byte 
following the Member ID/EX defines the remainder of the protocol. 


The Extended Protocol ID value conforms to the standard reserved ranges for open/vendor 
specific/ reserved ranges. 


Table A-5.4 Service Data for Extended Format Member Request Messages 


Name Data Type Description of Parameter 
Attribute ID’ USINT Identifies the attribute the member is to be serviced. 


The lower 15 bits identifies the Member ID identifies 
Member ID / EX2. | WORD attribute of the new member to be serviced. If the value is 
zero (0) the service used determines the behavior. 


Extended Protocol Option EX= 1 (Bit 15) 


Selects the extended protocol used for the remainder of 
pacer eae USINe message, per Extended Protocol ID table. 


Protocol specific Additional request data is defined by the extended protocol. 


This parameter shall be present when the target of the request is on a subnet, which does not support explicit 
message addressing to the attribute level. If the subnet does support attribute level addressing then this 
parameter shall not be present. In the latter case, the data type of the Attribute ID can be either USINT, UINT, 
or UDINT. 


* This parameter shall be present when the target of the request is on a subnet, which does not support explicit 
message addressing to the member or attribute level. If the subnet does support attribute and member level 
addressing then this parameter shall not be present. In this latter case, the data type of the Member ID/EX can 
be either BYTE, WORD, or DWORD with the most significant bit being the Extended Protocol Option 
parameter and the remaining bits being the Member ID. 


Table A-5.5 Service Data for Extended Format Member Response Messages 


Name Data Type Description of Parameter 


Protocol specific Response data is defined by the extended protocol option. 


The following table contains a list of the currently defined values for the Extended Protocol ID. 


Table A-5.6 Extended Protocol ID 


Value Description 

0 Reserved for future CIP use 

1 Multiple Sequential Members 
2 International String Selection 
3-63hex Reserved for future CIP use 
64hex-C7hex Vendor Specific 
C8hex-FFhex Reserved for future CIP use 
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A-5.3.1 


Multiple Sequential Members - Extended Protocol 


When the Extended Protocol ID is set to Multiple Sequential Members [1], the following 
protocol is used: 


Table A-5.7 Service Data for Multiple Sequential Member Request Messages 


Name Description of Parameter 
Attribute Ip! | USINT Identifies the attribute the member is to be serviced. 


The lower 15 bits identifies the Member ID identifies attribute of the 
Member ID / | WORD new member to be serviced. If the value is zero (0) the service used 
EX? determines the behavior. 
Extended Protocol Option EX= 1 (Bit 15) 


Extended USINT [01] Selects the Multiple Sequential Members protocol option 
Protocol ID 

Number of |UINT The number of members to be serviced. 

Members 


Member Data | Member specific } Multiple sequential Member Data 


This field is required by some services, see individual service 
descriptions. 


(conditional) 


' This parameter shall be present when the target of the request is on a subnet, which does not support 
explicit message addressing to the attribute level. If the subnet does support attribute level addressing 
then this parameter shall not be present. In this latter case, the data type of the Attribute ID can be either 
USINT, UINT, or UDINT. 


* This parameter shall be present when the target of the request is on a subnet, which does not support 
explicit message addressing to the member or attribute level. If the subnet does support attribute and 
member level addressing then this parameter shall not be present. In the latter case, the data type of the 
Member ID/EX can be either BYTE, WORD, or DWORD with the most significant bit being the 
Extended Protocol Option parameter and the remaining bits being the Member ID. 


Table A-5.8 Service Data for Member Response Messages (Extended Protocol) 


Name Description of Parameter 
Number of The number of members serviced. This field is 
Members required. 
Member ID The Member ID of the first member serviced. 
(conditional) This field is required by some services, see 
individual service descriptions. This field is required 
if the Member Data field is present. 
Member Data _| Member specific Multiple sequential Member Data 
(conditional) This field is required by some services, see 


individual service descriptions. 
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A-5.3.2 International String Selection— Extended Protocol 


Returns a single international character string from an attribute, which has a data type of 
STRINGI. This service can request a specific language or default to the current ‘active’ 
language as specified by the Identity Object. 


Service Requirements 
The International String Selection protocol requires the following behavior: 


1. This member protocol causes the class/object to return an international string from an 
attribute of data type STRINGI. 


2. This member protocol is only valid with the Get_Member service. 


3. If the object or attribute to which the request is delivered does not support the 
service/protocol, then a Service Not Supported error is returned. 


4. If the attribute does not contain the requested language, then an Invalid Parameter error 
is returned. 


5. Ifthe Member ID parameter is zero, then the device shall return the active (default) 
language. This default language is set by the device and may optionally be changed 
through the Active Language attribute (Attribute ID 11) within the Identity object. 


6. A device shall support the Supported Language List attribute (Attribute ID 12) of the 
Identity object if this member protocol is supported. 


7. If the requested Member ID is valid but the string for that language is not currently 
available then an error shall be returned indicating Resource Unavailable (error code 
0x02) and no additional error code. The string for the active language (as indicated by 
the Active Language attribute of the Identity Object) shall always be available. 


Table A-5.9 Service Data for International String Selection Request Messages 


Name Data Type Description of Parameter 
Attribute ID USINT Identifies the attribute containing the international string. 
Member ID/EX | WORD The lower 15 bits identifies the language to retrieve. This value is the 


member ID (array index, starting at one) of the language within the 
Supported Language List attribute (Attribute ID 12) of the Identity object. 


Extended Protocol Option EX = 1 (Bit 15) 


Extended USINT Selects the International String Selection protocol option (value = 2). 
Protocol ID 
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Table A-5.10 Service Data for International String Selection Response Messages 


Name Data Type Description of Parameter 
International STRUCT of The character string in the requested language. This parameter 
String follows the definition of a single international character string within 
the STRINGI data type (CIP Common, Appendix C-4 Abstract 
Syntax Specification). 
USINT The language1 field from the STRINGI data type. 
USINT The language2 field from the STRINGI data type. 
USINT The language3 field from the STRINGI data type. 
EPATH Encoded Data Type of the international string. 
UINT Character set of the international string. 


OCTET_STRING 


International string 
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A-6.1 


CIP Encoding Examples 


The example object definitions presented in the following section are used as the basis for 
providing CIP Common Service encoding examples. 


Example Object Class Definitions 


Table A-6.1 lists the class codes of the example Object Classes. 


Table A-6.1 Class ID Codes For Example Classes 


Class Name | Class ID Code 
Class A 70hex 
Class B 7 \hex 
Class C 72hex 
Class D 73hex 


The tables below illustrate the attributes associated with Object Instances within these classes. 


Table A-6.2 Class A Object Instance Attributes 


Attribute Attribute Description 
Name ID Method 
attribute_1 1 UINT Gettable/ | Allows values in range of 1 - 9 
Settable 


attribute_2 SINT No limit to value 


attribute_3 3 DINT Gettable/ | No limit to value 
Settable 
Table A-6.3 Class B Object Instance Attributes 
Attribute | Attribute | Format Access Attribute Description 
Name ID Method 
attribute_1 1 DINT Gettable/ No limit to value 
Settable 


attribute_2 SINT No limit to value 


attribute_3 3 UINT Gettable/ Value limited to range of 10 - 20 
Settable 

attribute_4 4 UINT Gettable/ Value limited to range of 0 - 9 
Settable 


Table A-6.4 Class C Object Instance Attributes 


Attribute | Attribute | Format Access Attribute Description 
Name ID Method 

attribute_1 UINT No limit to value 

attribute_2 UINT No limit to value 


attribute_3 3 UINT Gettable/ Allows values in range of 1-5 
Settable 
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Table A-6.5 Class D Object Instance Attributes 


Attribute | Attribute | Format Access Attribute Description 
Name ID Method 
attribute_1 1 USINT _ | Gettable/ No limit to value 
Settable 
attribute_2 2 UINT Gettable/ No limit to value 
Settable 


A-6.2 Encoding Examples 


Examples showing how the CIP Common Services are encoded are provided on the following 
pages. Note that the examples assume that an Explicit Messaging Connection has already 
been established and, as such, the Connection IDs associated with the Explicit Messaging 
Connections have already been agreed upon. 
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A-6.2.1 Get_Attributes_All 


The Client wants to read all of the attributes from Instance #1 within Class D with one request. 
Assume the Explicit Messaging Connection was established across Group 3 and the Message 
Body Format was defined by the Server as DeviceNet (8/8). 


Client Server 
MAC ID=0A MAC ID =2 


Group 3 Message 


—— Assume the Client allocated Group 3 Message ID value 5 
Source MACID=0A 


Frag = 0, Transaction ID = 1, Destination MAC ID =2 
Service = Get_Attributes All Request 


Class D (class code = 73 hex) 
= Instance ID = 01 


Identifier = 11 101 001010, Data=42 01 73 01 


Group 3 Message 
Assume the Server allocated Group 3 Message ID value 0 


Source MAC ID =2 
Frag = 0, Transaction ID = 1, Destination MAC ID = 0A 
Service = Get_Attributes All Response (Success) 
iia Data (attribute_1 =5, attribute_2 = 7) 


Identifier = 11 000 000010, Data=4A 81 050700 
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A-6.2.2 Set_Attributes_All 


The Client wants to modify all of the attributes from Instance #2 within Class D with one 
request. Assume the Explicit Messaging Connection was established across Group 3 and the 
Message Body Format was defined by the Server as DeviceNet (8/8). 


Client Server 
MAC ID=0A MAC ID =2 


Group 3 Message 


Assume the Client allocated Group 3 Message ID value 4 
Source MACID=0A 


Frag = 0, Transaction ID = 1, Destination MAC ID =2 
Service = Set_Attributes_ All Request 


Class D (class code = 73 hex) 
Instance ID = 02 
| Attribute Data (attribute_1 =6, attribute_2 =8) 


Identifier = 11 100 001010, Data=42 02 73 02 060800 


Group 3 Message 
Assume the Server allocated Group 3 Message ID value 4 (same asthe Client !!) 


Source MAC ID =2 
Frag = 0, Transaction ID = 1, Destination MAC ID =0A 
[ Service = Set_Attributes_All Response (Success) 


Identifier = 11 100 000010, Data=4A 82 
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A-6.2.3 Reset 


The Client wants to Reset Instance #4 within Class B. Assume the Explicit Messaging 


Connection was established across Group 3 and the Message Body Format was defined by the 
Server as DeviceNet (16/16). 


Client Server 
MAC ID=0A MAC ID=2 


Group 3 Message 


Assume the Client allocated Group 3 Message ID value 3 
Source MACID=0A 
Frag = 0, Transaction ID =0, Destination MAC ID =2 
Service = Reset Request 
Class B (class code = 71 hex) 
= Instance ID = 04 


Identifier = 11 011 001010, Data =02 05 7100 0400 


Group 3 Message 
Assume the Server allocated Group 3 Message ID value 2 
Source MACID =2 
Frag = 0, Transaction ID =0, Destination MAC ID =0A 
- Service = Reset Response (Success) 


pe 11 010 000010, Data=0A 85 
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A-6.2.4 Start 


The Client wants to Start Instance #5 within Class C. Assume the Explicit Messaging 
Connection was established across Group 1 and the Message Body Format was defined by the 
Server as DeviceNet (8/16). 


Client Server 
MAC ID=0A MAC ID =2 


Group 1 Message 


Assume the Client allocated Group 1 Message ID value 1 
Source MACID =0A 
Frag = 0, Transaction ID = 1, Destination MAC ID =2 
Service = Start Request 
Class C (class code = 72 hex) 
Reise ID =05 


Identifier = 0 0001 001010, Data =42 06 72 ne 


Group 1 Message 
Assume the Server allocated Group 1 Message ID value 9 
Source MACID =2 
Frag = 0, Transaction ID = 1, Destination MAC ID = 0A 
- Service = Start Response (Success) 


jag ee eee le 0 1010 000010, Data =4A 86 
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A-6.2.5 Stop 


The Client wants to Stop Instance #9 within Class B. Assume the Explicit Messaging 
Connection was established across Group 3 and the Message Body Format was defined by the 
Server as DeviceNet (8/8). 


Client Server 
MAC ID=0A MAC ID =2 


Group 3 Message 


Assume the Client allocated Group 3 Message ID value 5 
Source MACID=0A 
Frag = 0, Transaction ID =0, Destination MAC ID =2 
Service = Stop Request 
Class B (class code = 71 hex) 
Instance ID = 09 


Identifier = 11 101 001010, Data =02 07 71 Bye 


Group 3 Message 
Assume the Server allocated Group 3 Message ID value 0 
Source MAC ID =2 
Frag = 0, Transaction ID =0, Destination MAC ID =0A 
fe Service = Stop Response (Success) 


gS SON ee ss 11 000 000010, Data=0A 87 
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A-6.2.6 Create 


The Client wants to Create an instance within Class A. Assume the Explicit Messaging 
Connection was established across Group 2 and the Message Body Format was defined by the 
Server as DeviceNet (8/8) 


Client Server 
MAC ID=0A MAC ID =2 


Group 2 Message 
Destination MAC ID =2 


Assume the Server allocated Group 2 Message ID 2 tothe client 
Frag = 0, Transaction ID =0, SourceMACID=0A 
Service = Create Request 
Class A (class code = 70 hex) 
Instance ID = 00 ( request can be sent to class 
vs. a pecific Object instance) 


pee ee el 10 000010010, Data=0A 08 70 ee 


Group 2 Message 
Source MACID =2 
Assume the Server allocated Group 2 Message ID value 3 for itself 
Frag = 0, Transaction ID =0, Destination MAC ID = 0A 
Service = Create Response (Success) 
fe Instance ID of newly creat ed Object =6 


Identifier = 10 000010 011, Data=0A 88 0600 
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A-6.2.7. Delete 
The Client wants to Delete Instance #3 within Class B. Assume the Explicit Messaging 


Connection was established across Group 3 and the Message Body Format was defined by the 
Server as DeviceNet (8/16). 


Client Server 


MAC ID = 0A MAC ID =2 


Group 3 Message 


Assume the Client allocated Group 3 Message ID value 5 
Source MACID=0A 
Frag = 0, Transaction ID = 1, Destination MAC ID =2 
Service = Delete Request 
Class B (class code = 71 hex) 
— Instance ID = 03 


2 EO ee eS ee 11 101 001010, Data=42 09 71 0300 


Group 3 Message 
Assume the Server allocated Group 3 Message ID value 0 
Source MAC ID =2 
Frag = 0, Transaction ID = 1, Destination MAC ID = 0A 
- Service = Delete Response (Success) 


De 11 000 000010, Data=4A 89 


— A-46 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Appendix A: Explicit Messaging Services 


A-6.2.8 | Apply_Attributes 
The Client wants to send an Apply_Attributes to Instance #2 within Class C. Assume the 


Explicit Messaging Connection was established across Group 2 and the Message Body Format 
was defined by the Server as DeviceNet (16/16). 


Client Server 
MAC ID=0A MAC ID =2 


Group 2 Message 


Destination MAC ID =2 
Assume the Server allocated Group 2 Message ID 1 to the 
client Frag = 0, Transaction ID =0, Source MACID=0A 
Service = Apply_Attributes Request 
Class C (class code = 72 hex) 
_ Instance ID =02 


TA TO DOOUI ROOT DIRS EDD Pe Ae =10 000010 001, Data =0A OD 7200 


= 
Group 2 Message 
Source MAC ID =2 
Assume the Server allocated Group 2 Message ID value 4 for itself 
Frag = 0, Transaction ID =0, Destination MAC ID =0A 
- Service = Apply_Attributes Response (Success) 


gE = 10000010 100, Data=O0A 8D 
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A-6.2.9 Get_Attribute_Single 


The Client wants to read Attribute #1 within Instance #2 of Class A. Assume the Explicit 
Messaging Connection was established across Group 1 and the Message Body Format was 
defined by the Server as DeviceNet (8/8). 


Client Server 
MAC ID =0A MAC ID =2 
Group 1 Message 
Assume the Client allocated Group 1 Message ID value 3 


Source MAC ID =0A 
Frag = 0, Transaction ID =0, Destination MAC ID =2 
Service = Get_Attribute_Single Request 
Class A (class code = 70 hex) 
Instance ID = 02 
Attribute ID =01 


Identifier =0 0011 001010, Data =02 OE 70 ic o1 


Group 1 Message 
Assume the Server allocated Group 1 Message ID value 8 
Source MAC ID =2 
Frag = 0, Transaction ID =0, Destination MAC ID =0A 
Service = Get_Attribute_Single Response (Success) 
[_ The Attribute data (value =9) 


Ph ee rT 0 1000 000010, Data =0A 8E 0900 
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A-6.2.10 


Set_Attribute_Single 


The Client wants to modify Attribute #1 within Instance #2 of Class A. Assume the Explicit 
Messaging Connection was established across Group 2 and the Message Body Format was 
defined by the Server as DeviceNet (8/16). 


Server 


MAC ID = 0A MAC ID =2 


Group 2 Message 
Destination MAC ID =2 


Assume the Server allocated Group 2 Message ID 1 to the 
client Frag =0, Transaction ID =0, Source MACID=0A 


Service = Set_Attribute_Single Request 
Class A (class code = 70 hex) 
Instance ID = 02 
oe ID =01 
merous Data =3 


Identifier = 10 000010 001, Data =0A 10 70 0200 x es 


Group 2 Message 
Source MAC ID =2 
Assume the Server allocated Group 2 Message ID value 4 for itself 
Frag = 0, Transaction ID =0, Destination MAC ID =0A 
ti Service = Set_Attribute_Single Response 
(Success) 


gE ON Ue =10 000010 100, Data=0A 90 
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A-6.2.11 Find_Next_Object_Instance 


The Client wants to read the list of Instance IDs associated with existing Objects within Class 
A. Assume the Explicit Messaging Connection was established across Group 2 and the 
Message Body Format was defined by the Server as DeviceNet (8/8). Assume also that the 
Instance IDs 01pex and 15pex exist. 


Client Server 
MAC ID=0A MAC ID =2 


Group 2 Message 
Destination MAC ID =2 


Assume the Server allocated Group 2 Message ID 1 to the 


client Frag = 0, Transaction ID =0, Source MACID=0A 
Service = Find_Next_Object_Instance Request 
Class A (class code = 70 hex) 
Instance ID =00 
f Maximum Returned Values = 


Identifier = 10 000010 001, Data =0A 11 70 00 02 


Group 2 Message 
Source MAC ID =2 
Assume the Server allocated Group 2 Message ID value 4 for itself 
Frag = 0, Transaction ID = 0, Destination MAC ID =0A 
Service = Find_Next_Object_Instance Response (Success) 
eo of List Members = 2 
| Instance ID List: values of 1 and 15 
4 eee eS = 10 000010 100, Data=OA 91 02 0100 1500 


Group 2 Message 
Destination MAC ID =2 
—— Assume the Server allocated Group 2 Message ID 1 to the 
clien Frag = 0, Transaction ID =0, Source MACID=0A 
Service = Find_Next_Object_Instance Request 


Class A (class code = 70 hex) 
Instance ID =15 
[ Maximum Returned Values = 2 


Identifier = 10 000010 001, Data=OA 11 70 15 [ 


Group 2 Message 
Source MAC ID =2 


Assume the Server allocated Group 2 Message ID value 4 for itself 
Frag = 0, Transaction ID = 0, Destination MAC ID =0A 
Service = Find_Next_Object_Instance Response (Success) 
Number of List Members = 1 
fie Instance ID List: value 0 (end of list) 


gg ee OE ee Ue a 000010 100, Data=0A 91 01 he 
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A-6.2.12 


Restore 


The Client wants to send a Restore Request to Instance #3 within Class B. Assume the Explicit 
Messaging Connection was established across Group 3 and the Message Body Format was 
defined by the Server as DeviceNet (8/8). 


Client Server 
MAC ID = 0A MAC ID =2 


Group 3 Message 


Assume the Client allocated Group 3 Message ID value 5 
Source MACID=0A 
Frag =0, Transaction ID = 1, Destination MAC ID =2 
Service = Restore Request 
Class B (class code = 71 hex) 
Instance ID = 03 


Identifier = 11 101 001010, Data =42 15 71 as 


Group 3 Message 
Assume the Server allocated Group 3 Message ID value 0 
Source MAC ID =2 
Frag =0, Transaction ID = 1, Destination MAC ID =0A 
ie Service = Restore Response (Success) 


ge ee ee 11 000 000010, Data=4A 95 
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A-6.2.13 Save 


The Client wants to send a Save Request to Instance #5 within Class C. Assume the Explicit 
Messaging Connection was established across Group 1 and the Message Body Format was 
defined by the Server as DeviceNet (16/16). 


Client Server 


MAC ID = 0A MAC ID =2 


Group 1 Message 


Assume the Client allocated Group 1 Message ID value 1 
Source MACID=0A 
Frag = 0, Transaction ID = 1, Destination MAC ID =2 
Service = Save Request 
Class C (class code = 72 hex) 
= Instance ID = 05 


eo I SO eee I ea 00001 001010, Data=42 16 7200 0500 


Group 1 Message 
Assume the Server allocated Group 1 Message ID value 9 
Source MACID =2 
Frag = 0, Transaction ID = 1, Destination MAC ID = 0A 
/- Service = Save Response (Success) 


Fe  ——— 0 1010 000010, Data =4A 96 
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A-6.2.14 No Operation 


The Client wants to send a No Operation (NOP) to Instance #2 within Class C. Assume the 
Explicit Messaging Connection was established across Group 2 and the Message Body Format 
was defined by the Server as DeviceNet (16/16). 


Client Server 
MAC ID=0A MAC ID =2 


Group 2 Message 
Destination MAC ID =2 


Assume the Server allocated Group 2 Message ID 1 to the client 
Frag = 0, Transaction ID = 0, SoureeMACID=0A 
Service = No Operation Request 
Class C (class code = 72 hex) 
Instance ID = 02 


pe 10 000010 001, Data=0A 17 7200 A? 


Group 2 Message 
Source MACID =2 
Assume the Server allocated Group 2 Message ID value 4 for itself 
Frag = 0, Transaction ID = 0, Destination MAC ID =0A 
- Service = No Operation Response (Success) 


Sg I SOR 10 000010 100, Data=0A 97 
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A-6.2.15 Error Response 


The Client wants to Reset Instance #1 within Class D. Assume the Explicit Messaging 
Connection was established across Group 1 and the Message Body Format was defined by the 
Server as DeviceNet (8/8). Assume also that Objects within Class D do not support the Reset 


service. 
Client Server 
MAC ID =0A MAC ID =2 


Group 1 Message 


Assume the Client allocated Group 1 Message ID value 3 
Source MACID=0A 
Frag = 0, Transaction ID = 1, Destination MAC ID =2 
Service = Reset Request 
Class D (class code = 73 hex) 
— Instance ID = 1 


OE eS ee 00011 001010, Data=42 05 73 01 


Group 1 Message 


Assume the Server allocated Group 1 Message ID value OF 
Source MACID =2 
Frag =0, Transaction ID = 1, Destination MAC ID = 0A 
Service = Error Response 
General Error Code (Service Not Supported) 
—— Addit ional Code (Object specific meaning) 


Identifier =O 1111000010, Data=4A 94 08 05 
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A-6.2.16 Get_Member 


The Client wants to read Member #4 of Attribute #3 within Instance #2 of Class D. Assume 
the Explicit Messaging Connection was established across Group 1 and the Message Body 
Format was defined by the Server as DeviceNet (8/8). 


Client Server 
MAC ID =0A MAC ID =2 
Group 1 Message 
Assume the Client allocated Group 1 Message ID value 3 
Source MAC ID =0A 
Frag = 0, Transaction ID =0, Destination MAC ID =2 


Service = Get_Member Request 
Class D (class code = 73 hex) 
Instance ID = 02 
[se ID =03 
mee ID=04 
[ ex-, basic format ) 


Identifier =0 0011 001010, Data=02 18 73 02 03 04 


Group 1 Message 


Assume the Server allocated Group 1 Message ID value 8 
Source MAC ID =2 
Frag =0, Transaction ID =0, Destination MAC ID =0A 
Service = Get_Member Response (Success) 
[ ID=04 
(ee Data =22 


eS 0 1000 000010, Data =0A 98 lr ye 
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A-6.2.17 


Set_Member 


The Client wants to modify Member #5 of Attribute #3 within Instance #1 of Class D. Assume 
the Explicit Messaging Connection was established across Group 2 and the Message Body 
Format was defined by the Server as DeviceNet (8/8). 


Server 


MAC ID = 0A MAC ID =2 


Group 2 Message 
Destination MAC ID =2 


Assume the Server allocated Group 2 Message ID 1 to the 
client Frag =0, Transaction ID =0, Source MACID=0A 


Service = Set_Member Request 
Class D (class code = 73 hex) 


Instance ID = 01 
Attribute ID = 03 
Member ID = 05 
(EX =0, basic format) 
[—— Member Data = 5D 


Identifier = 10 000010 001, Data=0A 19 73 01 03 05 5D 


Group 2 Message 
Source MAC ID =2 
Assume the Server allocated Group 2 Message ID value 4 for itself 
Frag = 0, Transaction ID =0, Destination MAC ID =0A 
- Service = Set_Member Response (Success) 


Pe =10 000010 100, Data=O0A 99 
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A-6.2.18 Insert_Member 


The Client wants to Add Member #14 of Attribute #3 within Instance #3 of Class D. Assume 
the Explicit Messaging Connection was established across Group 1 and the Message Body 
Format was defined by the Server as DeviceNet (8/8). 


Client Server 
MAC ID=0A MAC ID =2 
Group 1 Message 
Assume the Client allocated Group 1 Message ID value 3 
Source MAC ID =0A 
Frag = 0, Transaction ID = 0, Destination MAC ID =2 


Service = Insert_Member Request 
Class D (class code = 73 hex) 
Instance ID =03 
= ID =03 
eee ID=14 
[ ex-o, basic format ) 


Identifier =0 0011 001010, Data=02 1A 73 03 [rc 14 


Group 1 Message 


Assume the Server allocated Group 1 Message ID value 8 
Source MAC ID =2 
Frag = 0, Transaction ID =0, Destination MAC ID =0A 
Service = Insertt_Member Response (Success) 
i Member ID = 14 


PP inlaid as ee 0 1000 000010, Data =OA 9A 14 
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A-6.2.19 Remove_Member 


The Client wants to remove Member #9 of Attribute #3 within Instance #1 of Class D. Assume 
the Explicit Messaging Connection was established across Group 2 and the Message Body 
Format was defined by the Server as DeviceNet (8/8). 


Client Server 
MAC ID=0A MAC ID =2 


Group 2 Message 
Destination MAC ID =2 


Assume the Server allocated Group 2 Message ID 1 to the 
client Frag = 0, Transaction ID =0, Source MACID=0A 


Service = Remove_Member Request 


Class D (class code = 73 hex) 
Instance ID = 01 
Attribute ID = 03 
i Member ID = 09 
| (EX =0, basic format) 


a EE AONE DS a DEO = 10000010 001, Data=0A 1B 73 01 03 09 


eee 2 Message 
Source MAC ID =2 
Assume the Server allocated Group 2 Message ID value 4 for itself 
Frag = 0, Transaction ID =0, Destination MAC ID =0A 
Service = Remove_Member Response (Success) 
ke Member Information = A5 


S (ee  ________ =10 000010 100, Data=O0A 9B AS 
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B-1 


General Status Codes 


The following table lists the Status Codes that may be present in the General Status Code field 
of an Error Response message. Note that the Extended Code Field is available for use in further 
describing any General Status Code. Extended Status Codes are unique to each General Status 
Code within each object. Each object shall manage the extended status values and value ranges 
(including vendor specific). All extended status values are reserved unless otherwise indicated 
within the object definition. 


Table B-1.1 CIP General Status Codes 


General Status Status Name Description of Status 
Code 
(in hex) 

00 Service was successfully performed by the object specified. 

01 Connection failure A connection related service failed along the connection path. 

02 Resource unavailable Resources needed for the object to perform the requested service were unavailable 

03 Invalid parameter value See Status Code 0x20, which is the preferred value to use for this condition. 

04 Path segment error The path segment identifier or the segment syntax was not understood by the processing 
node. Path processing shall stop when a path segment error is encountered. 

05 Path destination unknown The path is referencing an object class, instance or structure element that is not known 
or is not contained in the processing node. Path processing shall stop when a path 
destination unknown error is encountered. 

06 Partial transfer Only part of the expected data was transferred. 

07 Connection lost The messaging connection was lost. 

08 Service not supported The requested service was not implemented or was not defined for this Object 
Class/Instance. 

09 Invalid attribute value Invalid attribute data detected 

0A Attribute list error An attribute in the Get_Attribute_List or Set_Attribute_List response has a non-zero 
status. 

0B Already in requested The object is already in the mode/state being requested by the service 

mode/state 

OC Object state conflict The object cannot perform the requested service in its current mode/state 

0D Object already exists The requested instance of object to be created already exists. 

OE Attribute not settable A request to modify a non-modifiable attribute was received. 

OF Privilege violation A permission/privilege check failed 

10 Device state conflict The device’s current mode/state prohibits the execution of the requested service. 

11 Reply data too large The data to be transmitted in the response buffer is larger than the allocated response 
buffer 

12 Fragmentation of a primitive | The service specified an operation that is going to fragment a primitive data value, i.e. 

value half a REAL data type. 

13 Not enough data The service did not supply enough data to perform the specified operation. 

14 Attribute not supported The attribute specified in the request is not supported 

15 Too much data The service supplied more data than was expected 

16 Object does not exist The object specified does not exist in the device. 

17 Service fragmentation The fragmentation sequence for this service is not currently active for this data. 

sequence not in progress 

18 No stored attribute data The attribute data of this object was not saved prior to the requested service. 

19 Store operation failure The attribute data of this object was not saved due to a failure during the attempt. 
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General Status Status Name Description of Status 
Code 
(in hex) 

1A Routing failure, request The service request packet was too large for transmission on a network in the path to 
packet too large the destination. The routing device was forced to abort the service. 

1B Routing failure, response The service response packet was too large for transmission on a network in the path 
packet too large from the destination. The routing device was forced to abort the service. 

1C Missing attribute list entry The service did not supply an attribute in a list of attributes that was needed by the 
data service to perform the requested behavior. 

1D Invalid attribute value list The service is returning the list of attributes supplied with status information for those 

attributes that were invalid. 


1E Embedded service error An embedded service resulted in an error. 


1F Vendor specific error A vendor specific error has been encountered. The Additional Code Field of the Error 
Response defines the particular error encountered. Use of this General Error Code 
should only be performed when none of the Error Codes presented in this table or 
within an Object Class definition accurately reflect the error. 


20 Invalid parameter A parameter associated with the request was invalid. This code is used when a 
parameter does not meet the requirements of this specification and/or the requirements 
defined in an Application Object Specification. 


21 Write-once value or medium | An attempt was made to write to a write-once medium (e.g. WORM drive, PROM) that 
already written has already been written, or to modify a value that cannot be changed once established. 


22 Invalid Reply Received An invalid reply is received (e.g. reply service code does not match the request service 
code, or reply message is shorter than the minimum expected reply size). This status 
code can serve for other causes of invalid replies. 


23 Buffer Overflow The message received is larger than the receiving buffer can handle. The entire message 
was discarded. 


24 Message Format Error The format of the received message is not supported by the server. 


25 Key Failure in path The Key Segment that was included as the first segment in the path does not match the 
destination module. The object specific status shall indicate which part of the key 
check failed. 


26 Path Size Invalid The size of the path which was sent with the Service Request is either not large enough 
to allow the Request to be routed to an object or too much routing data was included. 
27 Unexpected attribute in list An attempt was made to set an attribute that is not able to be set at this time. 


28 Invalid Member ID The Member ID specified in the request does not exist in the specified 
Class/Instance/Attribute 


29 Member not settable A request to modify a non-modifiable member was received 


2A Group 2 only server general This error code may only be reported by DeviceNet Group 2 Only servers with 4K or 
failure less code space and only in place of Service not supported, Attribute not supported and 
Attribute not settable. 


2B Unknown Modbus Error A CIP to Modbus translator received an unknown Modbus Exception Code. 
2C - CF Po Reserved by CIP for future extensions 


DO - FF Reserved for Object Class and | This range of error codes is to be used to indicate Object Class specific errors. Use of 
service errors this range should only be performed when none of the Error Codes presented in this 
table accurately reflect the error that was encountered. 
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C-1 Abstract Syntax Encoding Coding for Segment Types 


C-1.1 CIP Segments 


This section specifies the encoding for CIP segments. A CIP segment is a stream of encoded 
items used to reference, describe, and/or configure a specific CIP entity. Segments are usually 
grouped together in order to provide complete information. 


The encoding used for CIP segments has the following relationship with the encoding used to 
report CIP data types, thus allowing both to be intermixed: 


Table C-1.1 Segment Encoding/Data Reporting Relationships 


Encoding of 1* Byte Description 


00-9F hex Encoding for Segments 
AO-DF hex Encoding for Data Type Reporting 
EO-FF hex Reserved for future use 


A segment contains information indicating what segment type is specified, the format of the 
segment data, and the actual segment data. Encoding for the following segment types is 
described in section C-1.4: 


e Port segment — used for routing from one subnet to another 

e Logical segment - logical reference information (such as class/instance/attribute IDs) 

e Network segment - specifies network parameters needed to transmit on a some networks 
e Symbolic segment - symbolic name 

e Data segment - embedded data (such as configuration data) 


Rules for how the segments are ordered and the interpretation of their meaning are described in 
section C-1.5. 


C-1.2 Usage of Segments for Paths 


A common use of CIP segments is to specify relationships among different objects. A value 
used to specify such a relationship is referred to as a path. A path attribute consists of multiple 
segments, and typically references the class, instance, and attribute of another object. A path 
has data type EPATH. 


Some examples of how paths are used include: 


e In Connection and Connection Manager Objects, paths indicate the object(s) to/from 
which I/O data is moved. 

e In Assembly Objects, paths indicate the attributes in other objects which are used to 
form the assembled I/O data. 

e In Parameter Objects, paths indicate the actual attribute in another object which is being 
described by the Parameter Object. 


An example of a path attribute is shown in Figure C-1.1. For an example encoding for such a 
path, refer to section C-1.4. 
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C-1.3 


C-1.4 


Figure C-1.1 Example Path Attribute 


Object Referenced by 
Path 


Attribute Referenced by 
Path 


Path Attribute 


Logical Data 
Segments | Segment 


Object Specific Configuration Data 


Logical Reference to 
Class / Instance / Attribute 


Path Format 


A path (data type EPATH) can be represented in two different formats: 
Padded Path (indicated as data type Padded EPATH) 
Packed Path (indicated as data type Packed EPATH) 


Each segment of a Padded Path shall be 16-bit word aligned. If a pad byte is required to 
achieve the alignment, the segment shall specify the location of the pad byte. A Packed Path 
shall not contain any pad bytes. When a component is defined as data type EPATH, it shall 
indicate the format (Packed or Padded). 


Segment Type 


Each segment of an encoding contains a segment type/format byte, which indicates how the 
segment is to be interpreted. The segment type/format information is contained in the first byte 
of the segment and, as such, the first byte of any encoding contains a segment type/format byte. 


~@a= 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Appendix C: Data Management 


Figure C-1.2 Segment Type/Format byte Encoding 


Segment Type Segment Format 
7 6 5 4 3 2 1 O 


The Segment Type bits are described below: 


Segment Type 
7 6 5 


Port Segment 

Logical Segment 

Network Segment 

Symbolic Segment 

Data Segment 

Data Type (constructed, see section C-2.1) 


Data Type (elementary, see section C-2.1) 


| el el ee > 
FP Oo OFF Oo CO 
FPF OF OF OF Oo 


Reserved for future use 


The meaning of the Segment Format bits is based on the specified Segment Type. 


The Port Segment, Logical Segment, Network Segment, Symbolic Segment, and Data Segment 
are described in sections C-1.4.1 to C-1.4.5. 


C-1.4.1 Port Segment 


The port segment shall indicate 

Communication port through which to leave the node; 

Link address of the next device in the routing path. 

The Port Segment is formatted as defined in the figure below. The bit representation is from 


high bit to low bit, left to right. The byte representation is from low byte to high byte, top to 
bottom and left to right. 
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Figure C-1.3 Port Segment Encoding 


Port Segment 


Segment Extended Link Port 
Address Size Identifier 


BEC eae 


Optional Link 
Address Size 


PIA EE al 


Optional Extended Port 
Identifier (2 Bytes) 


SRRPERER aE 


Link Address 


Bit 4, the Extended Link Address Size bit, shall be set to 0 if the link address is one byte. Bit 
4 shall be set to 1 if the link address is larger than one byte. If the link address is larger than 
one byte, its size in bytes shall be in the second byte of the Port Segment. 


Bits 0 — 3, the Port Identifier, shall indicate through which port to leave the node. The Port 
Identifier shall specify a Port Number or an escape to an extended port identifier when the 
module can support more than 14 ports. The list below defines rules pertinent to Port 
Identification/Port Number and Link Address values: 


Port Number 0 shall be reserved. 
Port Number 1 shall only be used to represent a back-plane port. 


If the Port Identifier is 15, then a 16-bit field, called the Extended Port Identifier, shall be the 
next part of the Port Segment (following the optional Link Address Size if present); otherwise, 
the value of the Port Identifier shall be the Port Number. 


The Port Number shall be followed by a Link Address whose format depends on the type of 
network to which the Port Identifier refers. If the Link Address is greater than one byte it shall 
be padded so that the length of the entire port segment is an even number of bytes. The pad 
byte shall be set to zero and shall not be included in the Link Address Size. With respect to the 
specification of a DeviceNet Port, the Link Address shall indicate the target DeviceNet MAC 
ID and be specified in a single byte whose value is 0 — 63 (the valid range of DeviceNet MAC 
Ids). 


The Extended Port Identifier format of the Port Segment shall only be used when there are 
more than 14 network ports possible on the connecting device. The Port Segment shall always 
be represented in the smallest Port Segment format possible with respect to the optional fields. 
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Examples of Port Segments are presented below. 


Table C-1.2 Port Segment Examples 


EPATH contents Notes 

[02][06] Segment Type = Port Segment. Port Number = 2, Link Address = 6 

[OF ][12][00][01] Segment Type = Port Segment. Port Identifier is 15 indicating the Port Number is 
specified in the next 16 bit field [12][00] (18 decimal). Link Address = 1. 

[15][OF][31][33][30][2E] Segment Type = Port Segment. Multi-Byte address for TCP Port 5, Link Address 

[31][35][31][2E1[31][33] 130.151.137.105 (IP Address). The address is defined as a character array, length 
of 15 bytes. The last byte in the segment is a pad byte. 

[37][2E][31][30][35][00] 


C-1.4.2 Logical Segment 


The logical segment selects a particular object address within a device (for example, Object 
Class, Object Instance, and Object Attribute). When the logical segment is included within a 
Packed Path, the Logical Value shall be appended to the segment type byte with no pad in 
between. When the logical segment is included within a Padded Path, the 16-bit and 32-bit 
logical formats shall have a pad inserted between the segment type byte and the Logical Value 
(the 8-bit format is identical to the Packed Path). The pad byte shall be set to zero. 


Figure C-1.4 Logical Segment Encoding 


Segment Format Bits 


Segment Type Logical Type Logical Format Logical Value 
0; Oo; 1 
Logical Type Logical Format 
Class ID 0 0 O 0 0 8-bit logical address 
InstanceID 9 O 1 0 1 16-bit logical address 
MemberID 0 1 O 1 O 32-bit logical address 
Connection Point 9 1 1 1 1 Reserved for future use 
Attribute ID 1 0 O 
Special* 1 O 1 
Service ID* 1 1 0 
Reserved for future use 1 1 1 


*The Special and Service ID Logical Types do not use the logical addressing definition for the Logical Format. 
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The 8-bit and 16-bit logical address formats are allowed for use with all Logical Types. 


The 32-bit logical address format is only allowed for the logical Instance ID and Connection 
Point types. It is not allowed for any other Logical Type (reserved for future use). 


The Connection Point Logical Type provides additional addressing capabilities beyond the 
standard Class ID/Instance ID/Attribute ID/Member ID Object Address. Object Classes shall 
define when and how this addressing component is utilized. 


The Service ID Logical Type has the following definition for the Logical Format: 


00 8-Bit Service ID Segment (0x38) 
01 Reserved for future use (0x39) 
10 Reserved for future use (0x3A) 
11 Reserved for future use (0x3B) 


The Special Logical Type has the following definition for the Logical Format: 


00 Electronic Key Segment (0x34) 
01 Reserved for future use (0x35) 
10 Reserved for future use (0x36) 
11 Reserved for future use (0x37) 


The Electronic Key segment shall be used to verify/identify a device. Possible uses include 
verification during connection establishment and identification within an EDS file. This 


segment has the format as shown in the table below. 


Table C-1.3 Electronic Key Segment Format 


Field Name Data Type Semantics 
Segment Type USINT A value of 0x34 indicates a Logical Electronic Key segment 
Key Format USINT 0 — 3 = Reserved 


4 = see Key Format Table 
5 — 255 = Reserved 


Key Data Array of octet Depends on key format used 


Table C-1.4 Key Format Table 


Format Field Name Data Semantics 
Value Type 
4 Vendor ID UINT Vendor ID 

Device Type UINT Device Type 

Product Code UINT Product Code 

Major Revision / BYTE Bits 0 — 6 = Major Revision 

Compatibility Bit 7 = Compatibility (If clear then any non-zero Vendor ID, 
Device Type, Product Code, Major Revision, and Minor Revision 
shall match. If set, then any key may be accepted which a device 
can emulate.) 

Minor Revision USINT | Minor Revision 
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An encoding that specifies Class #5, Instance #2, and Attribute ID #1 is illustrated below (Note 
that the packed and padded representations are the same): 


Figure C-1.5 Packed EPATH with 8 bit Class 


Segment Type= Logical Segment 
Segment Format: Logical Type = Class 
Format = 8 bits 


Segment Type= Logical Segment 
Segment Format: Logical Type = Instance 
Logical Format = 8 bits 
Segment Type = Logical Segment 
Segment Format: Logical Type = Attribute ID 
f Logical Format = 8 bits 


Class #5 Instance #2 Attribute ID #1 


The same example is presented below, except that the Class information is specified in a 16 bit 
field. Figure C-1.6 shows a packed representation and Figure C-1.7 shows padded. 


Figure C-1.6 Packed EPATH with 16 bit Class 


Segment Type = Logical Segment 
Format: Logical Type = Class Segment 
Logical Format = 16 bits 
Segment Type = Logical Segment 
Segment Format: Logical Type = Instance 
Logical Format = 8 bits 
Segment Type = Logical Segment 
Segment Format: Logical Type = Attribute ID 
Logical Format = 8 bits 


[=[@]=[@[=[a 
oo 


Pas #5 Instance #2 Attribute ID #1 


Figure C-1.7 Padded EPATH with 16 bit Class 


21 00 05 00 24 02 30 01 


A Pad inserted here for padded representation 
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C-1.4.3 Network Segment 


The network segment shall be used to specify network parameters that may be required by a 
node to transmit a message across a network. The network segment shall immediately precede 
the port segment of the device to which it applies. In other words, the network segment shall 
be the first item in the path that the device receives. 


Figure C-1.8 Network Segment Encoding 


Neon Segment Network Segment 
Semen Sub-type Data 
Type 
0/;1//0 0 Data (One Byte) 
ol1io 1 Number of Data Data 
Words (One byte) (Variable length) 
L 
0 0 0 0 0 Reserved for future use 
0 0 0 0 1 Schedule Segment 
0 0 0 1 O Fixed Tag Segment 
0 0 0 1 41 Production Inhibit Time 
0 0 1 #0 0 Reserved for future use 
thru 
0 1 1 4141 Reserved for future use 
1 0 0 0 O Safety Segment 
1 0 0 0 1 Reserved for future use 
thru 
1 1 1 41 0 Reserved for future use 
Ts vb ad: oA ed Extended Network Segment 


C-1.4.3.1 Schedule Network Segment 


Appendix C-2.1 of Volume 4 (ControlNet Adaptation of CIP) defines the Schedule network 
segment 


C-1.4.3.2 Fixed Tag Network Segment 


Appendix C-2.2 of Volume 4 (ControlNet Adaptation of CIP) defines the Fixed Tag network 
segment. 


C-1.4.3.3 Production Inhibit Time Network Segment 


The production inhibit time network segment shall specify the minimum time, in milliseconds, 
between successive transmissions of connected data for the specified connection. For example, 
if a production inhibit time of 10 milliseconds is specified, new data shall be sent no sooner 
than 10 milliseconds after the previous data. The network segment data field shall be a single 
USINT (8 bits) allowing for a range of 1 — 255 milliseconds. A value of zero shall indicate no 
production inhibit time. When this segment does not exist during establishment of a 
connection a default value of one-fourth the RPI shall be used. 


The RPI shall be larger than the production inhibit time. If the RPI is smaller than the 
production inhibit time, the Forward_Open_reply shall be returned with error (status 0x01, 
extended status 0x111). 
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C-1.4.3.4 


C-1.4.3.5 


Extended Network Segment 


The Extended Network Segment allows for the definition of additional Network Segment 
Subtypes. The first word of data is the Extended Network Segment Subtype. 


Figure C-1.9 Extended Network Segment Format 


Network Segment 
Segment Network Segment Data 
Sub-type 
Type 
Extended 
Number of Network Data 
0|;1/0 1;i;}1)1/1 Data Words Segment (Variable 
(One byte) Subtype (1 length) 
word) 


Each extended subtype defines the data that follows. The extended subtypes are enumerated in 


the table below. 


Table C-1.5 Extended Subtype Value Definition 


Extended Subtype Value Extended Subtype Definition 


0 — 65535 Reserved for future use 


Safety Network Segment 


The Safety network segment is defined in the CIP Safety Specification (Volume 5, Appendix 


C) 


—C-11- 
Edition 3.3 


ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Appendix C: Data Management 


C-1.4.4 Symbolic Segment 


The symbolic segment contains an International String symbol which must be interpreted by 
the device. 


Figure C-1.10 Symbolic Segment Encoding 


Segment Format Bits 


Segment Type Symbol Size in Bytes 

oO; 1] 1 
Size 1- 31: Length of ASCII symbol in bytes 
Size 0: Extended string. The next byte 


is the extended string format 


Extended string format byte: 
7 6 5 4 3 2 1 +O 


Format Size 
001 Number of Double-byte characters (1-31) 
010 Number of Triple-byte characters (1-31) 
110 


Numeric symbol type 
6 = USINT (0-255) 
7 = UINT (0-65535) 
8 = UDINT (0-4,294,967,295) 
All other values reserved 


Character Symbols can contain a maximum of 31 characters. 
Numeric Symbols can be 8, 16, or 32 bits. 
For example (values are hexadecimal): 


Table C-1.6 Symbolic Segment Examples 


Symbolic Segment Notes 


[65][LS101] ASCII Symbol. This could refer to a bit in a data structure 


(67][Line_23] 
[68][Wire_off] 
(60][22][1234][2345] 
(60][C7][1234] 
[60][C8][12345678] 


ASCII Symbol. This could refer to a controller in a slot 

ASCII Symbol. This could refer to a bit in a diagnostic structure 
Japanese symbol 

16 bit Numeric Symbol 

32 bit Numeric Symbol 
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C-1.4.5 Data Segment 


The data segment provides a mechanism for delivering data to an application. This may occur 
during connection establishment, or at any other time as defined by the application. 


Figure C-1.11 Data Segment Encoding 


Data Segment Segment Sub-Type Data Segment 
Type Data 
1) O| O Variable length 


00000 Simple Data Segment (0x80) 


00001 Reserved for future use 
thru 
10000 


10001 ANSI Extended Symbol Segment (0x91) 


10010 Reserved for future use 
thru 
11111 


C-1.4.5.1 Simple Data Segment 


The Simple data segment contains data values such as parameters for the target application. 
The size of the data segment is specified in number of 16 bit words and depends on the 
application. This byte value immediately follows the segment type. The data values follow the 
length byte. The data segment can be any number of 16 bit words up to 255. An encoding can 
contain more than one data segment if required. 


The following table provides examples of data segments: 


Table C-1.7 Data Segment Encoding 


Encoding Notes 


[80]L07] [0100] [0200] [0300] [0400] [0500] [0600] [0700] | Seven words of data in a data segment 


[21] [0500] [24] [09] [80][04] [0100] [0200] [0300] [0400] | Logical segments for Class 5, Instance 9, then four 


words of data in a data segment 


The data can be configuration information for the object, additional parameters necessary for 
the object, or any other set of object specific information. 
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C-1.4.5.2 ANSI Extended Symbol Segment 


The segment type of ANSI extended symbol segment shall be 0x91. The byte following the 
segment type (second byte) shall represent the number of characters (8-bit) in the symbol 
(symbol size). The variable length symbol shall follow the symbol size and shall end with a 
pad byte of zero if the size is of odd length. The symbol size shall not count the pad byte if it is 
included. 


The following table provides examples of extended symbol segments: 


Table C-1.8 ANSI Extended Symbol Segment Examples 


Encoding 
[91][06] [73] [74] [61] [72] [74] [31] 


Notes 


Six bytes of data in the symbol ‘start1’ 


(91] [07] [73] [74] [61][72] [74] [65] [72] [00] | Seven bytes of data in the symbol ‘starter’ (plus a null pad) 


C-1.5 Segment Definition Hierarchy 


The definition of any rules related to the use of segments is defined within the Object Class 
and/or Device Profile. The following are examples of valid recommended hierarchies. The 
depth within the hierarchy need only proceed to the degree required by its application. 


e Class ID, 

e Class ID, Instance ID 

e Class ID, Instance ID, Attribute ID 

e Class ID, Instance ID, Attribute ID, Member ID 


e Class ID, Connection Point 

e Class ID, Connection Point, Member ID 

e Class ID, Instance ID, Connection Point 

e Class ID, Instance ID, Connection Point, Member ID 
e Symbolic ID 

e Symbolic ID, Member ID 

e Symbolic ID, Connection Point 


The following example demonstrates encoding for two path attributes: the 
produced_connection_path and consumed_connection_path attributes of the Connection 
Object. 
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Figure C-1.12 Example Encoding for Connection Object Paths 


Connection Object Class (ID 5) Assembly Object Class (ID 4) 


Connection Instance ID 2 Assembly Instance ID 1 


connection_ ClassID 4, } = > 
path_length ; InstanceID1, : | MemberList | | 


: AttributeID3 : 
produced_ i i Data 
connection : : (Attribute ID 3) 


path 


consumed_ i i 
connection i : Assembly Instance ID 6 


path_length i ClassID4, 
See | Attribute ID 3 P Membertiss |_| 


path ; i Data 
i i (Attribute ID 3) 


C-1.6 Encoded Path Shortcut Rules 


When multiple encoded paths are concatenated the delineation between paths is where a 
segment at a higher level in the hierarchy is encountered. Multiple encoded paths may be 
compacted when each path shares the same values at the higher levels in the hierarchy. When a 
segment is encountered which is at the same or higher level but not at the top level in the 
hierarchy, the preceding higher levels are used for that next encoded path. The examples below 
show multiple encoded paths in the full and compacted representations. 


Full: Class A, Instance A, Attribute A, Class A, Instance A, Attribute B 
Compact: Class A, Instance A, Attribute A, Attribute B 


Full: Class A, Instance A, Attribute A, Class A, Instance B, Attribute A 
Compact: Class A, Instance A, Attribute A, Instance B, Attribute A 


C-2 Data Type Specification 


This section describes the data type specification syntaxes, data type value ranges, and 
operations that can be performed on the defined data types. The specification of a data type 
comprises: 


e the range of values that variables of the type may take on, and 
e the operations performed on these variables 
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This CIP standard specifies elementary and derived data types corresponding to the notation of 
IEC 1131-3. In addition, since function blocks as defined in IEC 1131-3 have both an 
associated data structure and a set of defined standard operations, these elements are also 
specified as data types in this CIP standard. 


C-2.1 Data Type Values 


Data is made up of elementary (primitive) data types. These elementary data types are used to 
construct derived (constructed) data types. 


C-2.1.1 Elementary Data Types 


The elementary data types and the values (range) of variables of each type are given in Table 
C-2.1 and its associated notes. This table specifies the values of certain parameters which are 
identified as “implementation—dependent” in Table 10.1 of subclause 2.3.1 in IEC 1131-3. The 
implementation—dependent parameters defined in this CIP Common specification can be found 
in Table C-3.4. 


Table C-2.1 Elementary Data Types 


Minimum Maximum 
BOOL NOTE 1 
SINT -128 127 
INT -32768 32767 


DINT Double Integer 331.4 
LINT Long Integer 763.1 


USINT Unsigned Short Integer lO) «YY 255 
UINT Unsigned Integer lO.) «65535 


UDINT Unsigned Double Integer Of 9824 
ULINT Unsigned Long Integer Oo 364_1 


REAL NOTE 2 
LREAL NOTE 3 
ITIME NOTE 12 
TIME NOTE 4 
FTIME NOTE 5,6 
LTIME NOTE 6,7 
DATE NOTE 8 
TIME_OF_DAY or TOD NOTE 9 
DATE_AND_TIME or DT NOTE 10 
STRING 

STRING2 NOTE 6 
STRINGN NOTE 6 
SHORT_STRING character string (1 byte per character, 1 NOTE 6 
STRINGI NOTE 6 
BYTE NOTE 11 
WORD NOTE 11 
DWORD NOTE 11 
LWORD NOTE 11 
EPATH NOTE 13 
ENGUNIT NOTE 14 
1 


The possible values of variables of type BOOL 0 and 1, corresponding to the keywords FALSE and 
TRUE, respectively. 
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Keyword Description Range 
Minimum Maximum 


The range of values for variables of type REAL are defined in IEEE 754 for the basic single 
floating-point format. 


3 The range of values for variables of type LREAL are defined in IEEE 754 for the basic double 
floating-point format. 


The range of values for variables of type TIME is the same as for variables of type DINT, representing 
the time duration in milliseconds, i.e., a range of T#-24d20h31m23.648s to T#24d20h31m23.647s. 


The range of values for variables of type FTIME is the same as for variables of type DINT, representing 
the time duration in microseconds, i.e., a range of T#-35m47.483648s to T#35m47.483547s. 

§ This is a CIP standard extension to IEC 1131-3. 

The range of values for variables of type LTIME is the same as for variables of type LINT, representing 


the time duration in microseconds, i.e., a range of T#-106751991d4h0m54.775808s to 
T#106751991d4h0m54.775807s. 


The range of values for variables of type DATE is from D#1972-01-01, the start of the Coordinated 
Universal Time (UTC) era, to D#2151-06-06 (a total range of 65536 days). 

9 The range of values for variables of type TIME_OF_DAY is from TOD#00:00:00.000 to 
TOD#23:59:59.999 to a resolution of 1 millisecond. 


10 The range of values for variables of type DATE_AND_TIME is from DT#1972-01-01-00:00:00.000 to 
DT#2151-06-06-23:59:59.999. 
Values of bit string data types is in the range 2#bpy_1byy_3...bpb; bg, where N is the number of bits in the 
bit string, bpy_7 is the “most significant bit”, and bg is the “least significant bit”. The value of the j-th bit 
bj is represented as 0 or 1, corresponding to the Boolean value FALSE or TRUE, respectively. 


The range of values for variables of type ITIME is the same as for variables of type INT, representing 
the time duration in milliseconds, i.e., a range of T#-32s768ms to T#32s767ms. 


13 For complete information on the EPATH data type, refer to Appendix C: Abstract Syntax Encoding for 


Segment Types. 


14 The range of values for variables of type ENGUNIT is the same as for variables uint, representing the 


values enumerated in Appendix D of the CIP specification. 
C-2.1.2 Character String Data Types 


The declaration of a variable of type STRING, STRING2, or STRINGN is equivalent to 
declaring a structured data type for the variable which allocates a UINT variable containing the 
current size of the string in characters and an array of declared character size elements. 
STRING declares 8-bit octet elements. STRING2 declares 16-bit octet elements. STRINGN 
declares N*8-bit octets. STRINGN includes a UINT variable which declares the character size. 
Character strings of data type STRING shall be based on ISO-8859-1. Character strings of data 
type STRING2 and STRINGN shall be based on ISO 10646. 


The declaration of a variable of type SHORT_STRING is equivalent to declaring a structured 
data type for the variable which allocates a USINT variable containing the current size of the 
string in characters and an array of 8-bit octet elements. Character strings of this data type shall be 
based on ISO-8859-1. 
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The declaration of a variable of type STRINGI is equivalent to declaring a structured data type 
for the variable which allocates a USINT variable containing the number of internationalized 
character strings and an array of structures containing the internationalized character strings. 
The international character string structure contains a USINT indicating the first ASCII 
character of the ISO 639-2/T language, a USINT indicating the second character of the ISO 
639-2/T language, a USINT indicating the third character of the ISO 639-2/T language, an 
EPATH (limited to the values 0xDO, 0xD5, 0xD9, and0xDA) indicating the structure of the 
character string, a UINT indicating the character set which the character string is based on , and 
an array of 8-bit octet elements which is the actual international character string. The three 
characters for the language come from ISO 639-2/T (Alpha-3 Terminology Code), and the 
character set values come from IANA MIB Printer Codes (RFC 1759). The character set 
values are limited to those values that are provided in Table C-2.3. Some common language 
codes are shown in Table C-2.2. 


SHORT_STRING, STRING2, STRINGN and STRINGI are extensions to IEC 1131-3. 


Table C-2.2 Common Language Codes from ISO 639-2/T 


Language First Character Second Character Third Character 
(language1) (language2) (language3) 

English e n g 
French f r a 
Spanish S p a 
Italian i t a 
German d e u 
Japanese j p n 
Portuguese p fe) r 
Chinese Z h ) 
Russian r u s 


Table C-2.3 Valid IANA MIB Printer Codes for Character Set Selection 


Character Set Value 
ISO-8859-1:1987 4 
ISO-8859-2:1987 5 
ISO-8859-3:1988 6 

Z 
8 
9 


ISO-8859-4:1988 
ISO-8859-5:1988 
ISO-8859-6:1987 


ISO-8859-7:1987 10 
ISO-8859-8:1989 11 
ISO-8859-9:1989 12 
ISO-10646-UCS-2 1000 
ISO-10646-UCS-4 1001 
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C-2.1.3 Structured Bit String Types 


Structured bit string types are a CIP extension of the derived data type mechanisms specified in 
subclause 2.2.3 of IEC 1131-3. These data types are based on the IEC standard bit string types 
(ANY_BIT = BYTE, WORD, DWORD, or LWORD). 


C-2.1.4 Derived Data Types 
The derived data types specified by CIP are: 


directly derived 
enumerated 
subrange 
structured 

array 


These data types are defined in subclauses 1.3 and 2.3.3 of IEC 1131-3. The means of 
specifying these data types and their default initial values is defined in subclauses 2.3.3.1 and 
2.3.3.2 of IEC 1131-3. The usage of variables of these data types is defined in subclause 2.3.3.3 
of IEC 1131-3. 


C-3 IEC 1131-3 Compliance 


Subclause 1.5.1 of IEC 1131-3 defines the requirements, which are met by programmable 
controller systems claiming compliance to the language standard. This provides the data 
type-related information to be included in the documentation of CIP functional units, which 
support the data types defined in this CIP standard. Subsets or extensions of this documentation 
are provided as appropriate to the specific compliant functional unit. 


This section provides information with respect to only the data types and associated operations 
defined in this CIP standard. For full compliance with IEC 1131-3, documentation of the 
additional language elements supported by the functional unit must be provided as prescribed 
in subclause 1.5.1 of IEC 1131-3. 


Included in this section are the following: 


e Compliance Statement 

e Implementation-Dependent Parameters 
e Error Conditions 

e Language Extensions 

e Formal Syntax 


C-3.1 Compliance Statement 


This system complies with the requirements of IEC 1131-3 for the following language features: 


Table C-3.1 Common Elements 


Table/ Feature Feature description 
10/1 BOOL data type 
10/2 SINT data type 
10/3 INT data type 
10/4 DINT data type 
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Table/ Feature Feature description 
10/5 LINT data type 
10/6 USINT data type 
10/7 UINT data type 
10/8 UDINT data type 
10/9 ULINT data type 
10/10 REAL data type 
10/11 LREAL data type 
10/12 TIME data type 
10/13 DATE data type 
10/14 TIME_OF_DAY or TOD data type 
10/15 DATE_AND_TIME or DT data type 
10/16 STRING data type 
10/17 BYTE data type 
10/18 WORD data type 
10/19 DWORD data type 
10/20 LWORD data type 
12/1 Directly derived data types 
12/2 Enumerated data types 
12/3 Subrange data types 
12/4 Array data types 
12/5 Structured data types 
13 Standard default initial values 
Subclause 2.5.1.3 User-declared functions (no table entry) 
22/1 Type conversions (see Table C-3.3) 
22/2 TRUNC function 
22/3 BCD_TO_** functions 
22/4 * TO_BCD functions 
23/1-11 Standard functions of one numeric variable: ABS, SQRT, LN, LOG, EXP, SIN, COS, 
TAN, ASIN, ACOS, ATAN 
24/12n-18n Standard named arithmetic functions: ADD, MUL, SUB, DIV, MOD, EXPT, MOVE 


24/12s-15s, 17s, 18s | Standard symbolic arithmetic functions: 
4851 IE 


25/1-4 Standard bit string functions: SHL, SHR, ROR, ROL 
26/5s-8s Standard named bitwise Boolean functions: 
AND, OR, XOR, NOT 
26/5s-7s Standard symbolic bitwise Boolean functions: 
&, >=1, =2k+1 
27/1-4 Standard selection functions: SEL, MAX, MIN, LIMIT, MUX 
28/5n-10n Standard named comparison functions: GT, GE, EQ, LE, LT, NE 
28/5s-10s Standard symbolic comparison functions: >, >=, =, <=, <, <> 
29/1-9 Standard character string functions: LEN, LEFT, RIGHT, MID, CONCAT, INSERT, 
DELETE, REPLACE, FIND 
30/1-14 Standard functions of time data types: ADD, SUB, MUL, DIV, CONCAT, 


DATE_AND_TIME_TO_TIME_OF_DAY, TIME _OF DAY _TO_DATE_AND_TIME 
NOTE- Table 30 of IEC 1131-3 limits the data types to which these operations apply. 


31/1-4 Standard functions of enumerated data types: SEL, MUX, EQ, NE 
32 Standard access mechanisms to function block I/O parameters 
33/8a, 8b, 9a, 9b User-defined function blocks per subclause 2.5.2.2, with graphical or textual rising or 
falling edge input options 
34/1-3 Standard bistable function blocks: SR, RS, SEMA 
35/1,2 Standard edge detection function blocks: RLEDGE, F_EDGE 
36/1-3 Standard counter function blocks: CTU, CTD, CTUD 
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Table/ Feature Feature description 
37/1,2a, 3a, 4 Standard timer function blocks: TP, TON, TOF, RTC 
55/1-17 Standard operators: (), function evaluation, **,—-, NOT, *, /, MOD, +,-, <, >, <=, >=, =, <>, 


&, AND, XOR, OR 


Table C-3.2 ST Language Elements 


Table/ 
Feature 


55/1-17 


Feature description 


Standard operators: (), function evaluation, **,-, NOT, *, /, MOD, +,-, <, >, <=, >=, =, <>, 
&, AND, XOR, OR 


56/2 Function block invocation and output usage 


Table C-3.3 Type Conversion Operations 


Refer to the notes following this table. 


Operation | Result | Error conditions 
ANY_BIT_TO_ANY_BIT (NOTE 4) None 
ANY_BIT_TO_ANY_INT OUT nin + Sb,2k (NOTE 5) Result > OUT pax 
ANY_BIT_TO_BOOL FALSE if IN =0 None 

TRUE otherwise 
ANY_BIT_TO_STRING (NOTE 6) None 
ANY_DATE_TO_STRING (NOTE 7) None 
ANY_INT_TO_BOOL FALSE if IN =0 None 

TRUE otherwise 
ANY_NUM_TO_ANY_INT IN (NOTE 8) (IN > OUT jax) OF 

(IN < OUT min) 

ANY_NOMTOANYREAL [IN —————~*SdNOTES) 
ANY_NUM_TO_DATE (NOTE 10) 
ANY_NUM_TO_STRING (NOTE 11) 
ANY_NUM_TO_TIME (NOTE 12) 
ANY_NUM_TO_TOD (NOTE 13) 
ANY_REAL TO_BOOL FALSE if IN = 0.0 None 

TRUE otherwise 
BOOL_TO_ANY_BIT 0 if IN = FALSE None 
BOOL_TO_ANY_INT 1 if IN= TRUE 
BOOL_TO_ANY_REAL 0.0 if IN = FALSE None 

1.0 if IN = TRUE 
BOOL_TO_STRING *FALSE’ if IN = FALSE None 

*TRUE’ if IN = TRUE 
DATE_TO_ANY_NUM (NOTE 14) Result > OUT 3x 
STRING_TO_ANY (NOTE 15) 
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Error conditions 


TIME_TO_ANY_NUM (NOTE 16) Result > OUT pax 
TOD_TO_ANY_NUM (NOTE 17) Result > OUT ax 


1 Use of the generic data types ANY_NUM, ANY_REAL, ANY_INT, and ANY_BIT defined in subclause 
2.3.2 of IEC 1131-3 is intended to imply a family of conversions. For instance, the conversion 
BOOL_TO_ANY_REAL is intended to imply BOOL_TO_REAL and BOOL_TO_LREAL. 


IN refers to the value of the input variable of the type conversion function. 


Operation 


OUT yin and OUT,,,, refer to the minimum and maximum values of the output data type of the conversion 
function, as defined in Table C-2.1. 


In conversions of bit string types, if the number of bits in the input variable IN is less than the number of the 
bits in the output variable OUT, the bits of the input is copied to the corresponding least significant bits of the 
result and the remainder of the result is zero-filled. If the number of bits of IN is greater than the number of 
bits of OUT, the least significant bits of IN is copied to the corresponding bits of the result. For instance, 
BYTE_TO_WORD(16#FF) = 16#00FF 
and 
WORD_TO_BYTE(16#0FFO) = 16#F0O 


Bit numbering in this expression is as specified in Note 11 of Table C-2.1. 


The result of conversion of a bit string variable to type STRING consists of a string containing the base 16 
literal representation of the variable value, as defined in subclause 2.2.1 of IEC 1131-3, in characters taken 
from the ISO 646 character set. 


The result of conversion of a date and/or time of day variable to type STRING consists of a string containing 
the literal representation of the variable value, as defined in subclause 2.2.1 of IEC 1131-3, in characters 
taken from the ISO 646 character set. 


Conversion of REAL and LREAL to integer types is accomplished by rounding as specified in subclause 5.4 
of IEEE 754. 


Rounding errors may occur if the number of significant bits in the input variable is larger than the number of 
significant bits in the output floating-point representation. Also, range errors of the type noted for 
ANY_NUM_TO_ANY_INT may occur in LREAL_TO_REAL. 


10 Conversion of a variable of a numeric type to DATE has the same result as conversion of the variable to 


UINT, with the result being interpreted as the number of days since 1972-01-01. 


11 Conversion of a variable of a numeric type to type STRING consists of a string containing the literal 


representation of the variable value, as defined in subclause 2.2.1 of IEC 1131-3, in characters taken from the 
ISO 646 character set. 


12 Conversion of a variable of a numeric type to TIME has the same result as conversion of the variable to 


DINT, with the result being interpreted as a duration in milliseconds. 


13 Conversion of a variable of a numeric type to TOD has the same result as conversion of the variable to 


UDINT, with the result being interpreted as a time since midnight in milliseconds. 


14 Conversion of a variable of type DATE to a numerical type is the same as the conversion of a variable of type 


UINT to the corresponding numerical type, with the result being the numerical equivalent of the days since 
1972-01-01. 


15 {tis an error if the STRING data to be converted is not in the format for external representation of the output 


data type as specified in subclause 2.2 of IEC 1131-3, or if the result of the conversion is outside the range 


{OUT i OUT avi 


16 Conversion of a variable of type TIME to a numerical type is the same as the conversion of a variable of type 


DINT to the corresponding numerical type, with the result being the numerical equivalent of the 
corresponding time interval expressed in milliseconds. 


17 Conversion of a variable of type TOD (TIME_OF_DAY) to a numerical type is the same as the conversion of 


a variable of type UDINT to the corresponding numerical type, with the result being the numerical equivalent 
of the time since midnight expressed in milliseconds. 
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C-3.2 Implementation-Dependent Parameters 
Table C-3.4 lists the values of implementation-dependent parameters from Table D.1 of IEC 
1131-3 that are defined in this CIP standard. Values of other implementation-dependent 
parameters are defined in other CIP standards or in the specifications of individual functional 
units as appropriate. 
Table C-3.4 Values of Implementation—dependent Parameters 
Clause Parameter Value 
of IEC 
1131-3 
2.2.3.1 Range of values of duration Same as LINT in microseconds 
2.3.1 Range of values for variables of type TIME Same as DINT in milliseconds 
Precision of representation of seconds in types 1 millisecond 
TIME _OF DAY and DATE_AND_ TIME 
2.3.3.1 Maximum number of enumerated values 256 
2.3.3.2 Default maximum length of STRING variables 256 
Maximum allowed length of STRING variables 65536 
2.4.1.2 Maximum number of subscripts 8 
Maximum range of subscript values 0..255 
Maximum number of levels of structures 8 
2.5.1.5 Maximum inputs of extensible functions 8 
2.5.1.5.1 Effects of type conversions on accuracy As defined in Table C-3.3 
2.5.1.5.2 Accuracy of functions of one variable As defined in IEEE 754 
2.5.2.3.3 PVmin, PVmax of counters 0, 65535 
C-3.3 Language Extensions 


The extensions to IEC 1131-3 defined in this CIP standard are listed in Table C-3.5. When 
these extensions are used in a particular CIP compliant functional unit, the subclause references 
in this table are replaced by references to the descriptions of the corresponding extensions in 
the functional unit’s documentation. 


Table C-3.5 CIP standard extensions to IEC 1131-3 


Subclause Description 


ITIME data type 

FTIME data type 

LTIME data type 
STRING2 data type 
STRINGN data type 
SHORT_STRING data type 


STRINGI data type 
EPATH data type 
ENGUNIT data type 


Structured bit string types 
Operations on STRING2 variables 
Numbered bit string access 


2.1.1 


2.1.4 
2.2 
2.2.4.1 
2.2.4.2 


Structured bit string access 
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C-4 Abstract Syntax Specification 


The lower layers of open system architectures are concerned with the transport of user data 
among distributed functional units. In these layers, the user data can be regarded simply as a 
sequence of octets. However, application layer entities may manipulate the values of quite 
complex data types. To achieve independence between the application layer and lower layers, 
data types are specified in an abstract syntax notation. 


Supplementing the abstract syntax with one or more algorithms (called encoding rules) 
determines the values of the lower layer octets which carry the application layer values. The 
combination of the abstract syntax with a single set of transfer rules produces a specific transfer 
syntax. 


Important: Users of this CIP standard should read and understand ISO 8824/8825, IEC 
1131-3, and section C-4, Abstract Syntax Specification. Refer to these documents when 
reading and applying this standard. 


The data type definitions provided in this CIP standard are written in Abstract Syntax Notation 
One (ASN.1), as defined in ISO 8824. These type definitions are part of the ASN.1 module 
“CIPDataTypes.” The beginning ASN.1 statement indicating that these definitions are in this 
module is: 


CIPDataTypes DEFINITIONS ::= BEGIN 
and the closing ASN.1 statement is the keyword “END”. 


The abstract definitions that follow comprise the set of CIP Data Types. In addition, provision 
is made to extend or derive new data types based on existing defined types, and to include 
those in a “type dictionary.” 


C-4.1 CIP Data Specification 


The notation [typeld] for directly derived, enumerated, subrange and structured bit string data 
means that the tag is to be taken from the “type” field in the corresponding 
VariableDictionaryEntry. 


CIPData : CHOICE{ElementaryData, DerivedData} 

ElementaryData ::= CHOICE{ 
BOOL, 

FixedLengthInteger, 
FixedLengthReal, 
AnyTime, 

AnyDate, 

AnyString, 
FixedLengthBitString, 
EPATH, 

ENGUNIT } 

DerivedData ::= CHOICE { 
DirectlyDerivedData, 
EnumeratedData, 

SubrangeData, 
StructuredBitStringData, 
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ARRAY, 
STRUCT, 
Funct ionBlockData} 


DirectlyDerivedData os typelId] CIPData 


[ 
EnumeratedData ae [typeId] USINT 
SubrangeData = [typeId] FixedLengthInteger 
StructuredBitStringData ::= [typeId] FixedLengthBitString 
FixedLengthInteger 2S CHOICE {SignedInteger, 
UnsignedInteger } 

SignedInteger ::= CHOICE {SINT, INT, DINT, LINT} 
UnsignedInteger ::= CHOICE {USINT, UINT, UDINT, ULINT } 
FixedLengthReal ::= CHOICE {REAL, LREAL} 
AnyTime = CHOICE {ITIME, TIME, FTIME, LTIME} 
AnyDate 7 CHOICE {DATE, TIME OF DAY, DATE AND TIME} 
AnyString = CHOICE {STRING, STRING2} 
FixedLengthBitString 23 CHOICE {BYTE, WORD, DWORD, LWORD } 
BOOL ::= [PRIVATE 1] IMPLICIT BOOLEAN 
SINT ::= [PRIVATE 2] IMPLICIT OCTET STRING-- 1 octet 
INT ::= [PRIVATE 3] IMPLICIT OCTET STRING-- 2 octets 
DINT ::= [PRIVATE 4] IMPLICIT OCTET STRING-- 4 octets 
LINT ::= [PRIVATE 5] IMPLICIT OCTET STRING-- 8 octets 
USINT ::= [PRIVATE 6] IMPLICIT OCTET STRING-- 1 octet 
UINT ::= [PRIVATE 7] IMPLICIT OCTET STRING-- 2 octets 
UDINT ::= [PRIVATE 8] IMPLICIT OCTET STRING-- 4 octets 
ULINT ::= [PRIVATE 9] IMPLICIT OCTET STRING-- 8 octets 
REAL ::= [PRIVATE 10] IMPLICIT OCTET STRING-- 4 octets 
LREAL ::= [PRIVATE 11] IMPLICIT OCTET STRING-- 8 octets 
STIME ::= [PRIVATE 12] IMPLICIT DINT 
DATE ::= [PRIVATE 13] IMPLICIT UINT 
TIME OF DAY ::= [PRIVATE 14] IMPLICIT UDINT 
DATE AND TIME::= [PRIVATE 15] IMPLICIT SEQUENCE { 

time _of day UDINT, 

date UINT } 
STRING ::= [PRIVATE 16] IMPLICIT SEQUENCE 

Charcount UINT, 

stringcontents OCTET STRING} -- one octet per character 
BYTE ::= [PRIVATE 17] IMPLICIT OCTET STRING-- 1 octet 
WORD = [PRIVATE 18] IMPLICIT OCTET STRING-- 2 octets 
DWORD ::= [PRIVATE 19] IMPLICIT OCTET STRING-- 4 octets 
LWORD ::= [PRIVATE 20] IMPLICIT OCTET STRING-- 8 octets 
STRING2 ::= [PRIVATE 21] IMPLICIT SEQUENCE 

charcount UINT, 

string2contents OCTET STRING} -- 2 octets/ character 
FTIME ::= [PRIVATE 22] IMPLICIT DINT 
LTIME = [PRIVATE 23] IMPLICIT LINT 
ITIME = [PRIVATE 24] IMPLICIT INT 
STRINGN ::= [PRIVATE 25] IMPLICIT SEQUENCE { 

charsize UINT, 

charcount UINT, 
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stringNcontents OCTET STRING} -- WN octets/ character 
SHORT_STRING ::= [PRIVATE 26] IMPLICIT SEQUENCE { 

charcount USINT, 

stringcontents OCTET STRING} -- one octet per character 
TIME ::= [PRIVATE 27] IMPLICIT DINT 
EPATH ::= [PRIVATE 28] IMPLICIT OCTET STRING -- Appendix C 
ENGUNIT ::= [PRIVATE 29] IMPLICIT OCTET STRING -- Appendix D 
STRINGI ::= [PRIVATE 30] IMPLICIT SEQUENCE{ 


Stringnum USINT (number of strings) 
array of STRUCT 
languagel USINT (first character from ISO 639-2/T) 
language2 USINT (second character from ISO 639-2/T) 
language3 USINT (third character from ISO 639-2/T) 
datatype EPATH limited to the values 0xD0O,0xD5,0xD9,and OxDA) 
charset UINT from IANA MIB Printer Codes (RFC 1759) ) 
stringcontents CHOICE OF (SHORT _STRING, STRING, STRING2, or 
STRINGN) -- based on datatype field 
ARRAY ::= SEQUENCE OF CIPData -- All of same base type 
STRUCT SEQUENCE OF CIPData -- May be different types 
FunctionBlockData ::= SET{ 


inputs IMPLICIT STRUCT OPTIONAL, 
outputs IMPLICIT STRUCT OPTIONAL, 
controlInputs IMPLICIT STRUCT OPTIONAL, 
controlOutputs IMPLICIT STRUCT OPTIONAL } 


[0] 
[1] 
[2] 
[3] 


C-4.2 Data Type Specification/Dictionaries 


The definition of a CIP object may include text that defines attributes. Attributes are assigned a 
Data Type in an object definition. The Data Type may be one of those defined in this appendix 
or may be an object specific extension to this appendix. The following definition provides a 
Type Specification for CIPData and provides a structure for extending or deriving new data 
types based on existing defined types. 


Dictionary ::= CHOICE {VariableDictionary, TypeDictionary} 
VariableDictionary ::= SEQUENCE OF VariableDictionaryEntry 
VariableDictionaryEntry ::= SEQUENCE { 

name AnyString, 

id FixedLengthInteger, 

type TypelID, 

ranges SEQUENCE OF Subrange,-- for arrays 

accessPrivilege BOOL {READ ONLY(0), READ WRITE(1) } 
TypeID := OCTET STRING -- ASN.1 encoded tag value of the 

-- DataTypeSpecification module 

Subrange res SEQUENCE { 


minValue FixedLengthInteger, 

maxValue FixedLengthInteger } 
TypeDictionary ::= SEQUENCE OF TypeDictionaryEntry 
TypeDictionaryEntry ::= SEQUENCE { 

name AnyString, 

type TypelID, 

spec DataTypeSpecification} 


DataTypeSpecification ::= CHOICE { 
alt [PRIVATE 0] IMPLICIT AlternateTypeSpec, 
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bool [PRIVATE 1] IMPLICIT NULL, BOOL 

sint [PRIVATE 2] IMPLICIT NULL, SINT 

int [PRIVATE 3] IMPLICIT NULL, INT 

dint [PRIVATE 4] IMPLICIT NULL, DINT 

lint [PRIVATE 5] IMPLICIT NULL, LINT 

usint [PRIVATE 6] IMPLICIT NULL, USINT 

uint [PRIVATE 7] IMPLICIT NULL, UINT 

udint [PRIVATE 8] IMPLICIT NULL, UDINT 

ulint [PRIVATE 9] IMPLICIT NULL, ULINT 

real [PRIVATE 10] IMPLICIT NULL, REAL 

lreal [PRIVATE 11] IMPLICIT NULL, LREAL 

stime [PRIVATE 12] IMPLICIT NULL, STIME 

date [PRIVATE 13] IMPLICIT NULL, DATE 

tod [PRIVATE 14] IMPLICIT NULL, TIME OF DAY 

dat [PRIVATE 15] IMPLICIT NULL, DATE AND TIME 

strl [PRIVATE 16] IMPLICIT NULL, STRING 

byte [PRIVATE 17] IMPLICIT NULL, BYTE 

word [PRIVATE 18] IMPLICIT NULL, WORD 

dword [PRIVATE 19] IMPLICIT NULL, DWORD 

lword [PRIVATE 20] IMPLICIT NULL, LWORD 

str2 [PRIVATE 21] IMPLICIT NULL, STRING2 

ftime [PRIVATE 22] IMPLICIT NULL, FTIME 

ltime [PRIVATE 23] IMPLICIT NULL, LTIME 

itime [PRIVATE 24] IMPLICIT NULL, ITIME 

strN [PRIVATE 25] IMPLICIT NULL, STRINGN 

shstr [PRIVATE 26] IMPLICIT NULL, SHORT STRING 

time [PRIVATE 27] IMPLICIT NULL, TIME 

epath [PRIVATE 28] IMPLICIT NULL, EPATH 

engunit [PRIVATE 29] IMPLICIT NULL, ENGUNIT 

strI [PRIVATE 30] IMPLICIT NULL, STRINGI 

constructedData CHOICE { 
abbrvStruc [0] IMPLICIT AbbreviatedStrucTypeSpec, 
abbrvArr 1] IMPLICIT AbbreviatedArrayTypeSpec, 
frmlStruc 2] IMPLICIT FormalStrucTypeSpec, 
frmlArr 3] IMPLICIT FormalArrayTypeSpec, 
expBitStr [4] IMPLICIT ExpandedFixedLenBitStrTypeSpec, 
expStr1 5] IMPLICIT ExpandedStringTypeSpec, 
expStr2 6] IMPLICIT ExpandedString2TypeSpec } 


} 


AbbreviatedStrucTypeSpec c= UINT 
AbbreviatedArrayTypeSpec 0S DataTypeSpecification 
SEQUENCE OF DataTypeSpecification 


FormalStrucTypeSpec = 

FormalArrayTypeSpec = SEQUENCE { 
lowBound [0] IMPLICIT FixedLengthInteger, -- Array Lower Bound 
highBound [1] IMPLICIT FixedLengthInteger, -- Array Upper Bound 
dataType DataTypeSpecification } 


ExpandedFixedLenBitStrTypeSpec = SEQUENCE { 
bitStrType DataTypeSpecification -- BYTE, WORD, DWORD, or LWORD 
bitFields [7] IMPLICIT BitFieldDef } 


BitFieldDef ::= SEQUENCE OF { 
bitDef [2] IMPLICIT OCTET STRING} 
-- Length is always 2 octets. 
-- First octet contains starting 
-- Bit Position. Trailing octet 
-- contains the number of bits. 
ExpandedStringTypeSpec ::= UINT-- String Length In Octets 
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ExpandedString2TypeSpec ::= UINT-- String Length In Octets 
AlternateTypeSpec ::= CHOICE { 
directlyDerivedTypeSpec [0] IMPLICIT TypelID, 
subrangeTypeSpec [1] IMPLICIT SubrangeTypeSpec, 
enumeratedTypeSpec [2] IMPLICIT enumeratedTypeSpec, 
fbTypeSpec [3] IMPLICIT FBTypeSpec } 
SubrangeTypeSpec ::= SEQUENCE{ 
baseType TypelID, -- NOTE: minValue and maxValue 
minValue FixedLengthInteger, -- must be within the range 
maxValue FixedLengthInteger} -- of baseType values 
EnumeratedTypeSpec ::= SEQUENCE OF AnyString 
BitNameDefintion ::= SEQUENCE { 
bitName AnyString, 
bitNumber USINT} 
FBTypeSpec ::= SET{ 
inputs [0] IMPLICIT FbtElementSpec OPTIONAL, 
outputs [1] IMPLICIT FbtElementTypeSpec OPTIONAL, 
controlInputs [2] IMPLICIT FbtElementTypeSpec OPTIONAL, 
controlOutputs [3] IMPLICIT FbtElementTypeSpec OPTIONAL} 
FbtElementTypeSpec ::= SEQUENCE OF ElementSpec 
ElementSpec ::= SEQUENCE { 
name AnyString, 
typespec Element TypeSpec } 
ElementTypeSpec ::= CHOICE { 


[0] IMPLICIT TypeID, 

[1] IMPLICIT SubrangeTypeSpec, 
[2] IMPLICIT EnumeratedTypeSpec, 
[3] IMPLICIT FormalArrayTypeSpec, 
[ 

[ 


4] IMPLICIT ExpandedStringTypeSpec, 
5] IMPLICIT ExpandedString2TypeSpec } 


Additional elements of “FBTypeSpec” are being considered. 


The following END statement terminates the ASN.1 module opened in section C-4. 


END. 


CIP Application Transfer Syntax: Compact Encoding 


This section describes the means by which the data types defined in section C-2.1 Data Type 
Values are encoded/transferred across CIP. The abstract syntax definition along with a 
particular set of encoding rules results in a transfer syntax. For CIP application user data, a 
single set of encoding rules is defined (Compact Encoding), resulting in the Compact transfer 
syntax. 


Compact Encoding rules start with the encoding rules defined in ASN.1 8825. Compact 
Encoding then applies optimization rules, starting with the outer most Service Data Unit (SDU) 
and progressing to each successive encapsulated SDU. Compact Encoding defines a more 
efficient encoding mechanism by reducing the amount of information (overhead) transferred 
between devices. 
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The difference between a Compact encoded value and an ASN.1 encoded value is the removal 
of the fields describing the type and length of the information. In other words, the TAG and 
LENGTH components of an ASN.1-encoded value are not transmitted on CIP. In addition, the 
Compact Encoding rules indicate that octet-ordering rules are the reverse of those seen in 
ASN.1. 


Given the conditions listed in the next section, the following general rules are applied to an 
ASN.1 encoded value to generate a Compact encoded value: 


e Remove the Identifier Octets. Remove the “TAG” octets specified by ASN.1. 
e Remove the Length Octets. Remove the “LENGTH” octets specified by ASN.1. 
e Reverse the byte ordering for multiple content octets. 


C-5.1 Compact Encoding Constraints 


Important: The representation of a variable value using Compact Encoding is only possible 
with the following restrictions: 


e Ina multi-peer communication relationship, the entities involved in the pre-established 
connection have prior knowledge of the variable type, and do not need to transmit the 
type description with the value of the variable. This knowledge is available by accessing 
the description of the variable and the variable type. 

e The variable type is fixed length and has no conditional or optional fields. 

e The encoding of a given variable is represented with a constant number of octets 
derived from the type specification of this variable. 


C-5.2 Encoding Rules/Examples 


This section lists rules specific to the various data types implemented in the CIP system and 
shows examples of the Compact Encoding. 


C-5.2.1 BOOL Encoding 


The boolean encoding is performed on a single OCTET. 


Table C-5.1 Boolean Encoding 


If the value is: Then: 
FALSE bit 0 of the octet is 0 (00H) 
TRUE bit 0 of the octet is 1 (’?01’H) 


The example illustrated below depicts the encoding of a BOOL whose value is FALSE. 


Table C-5.2 Example Compact Encoding of a BOOL Value 


Octet Number 1st 
BOOL 00 


C-5.2.2 SignedInteger Encoding 


This section gives you examples of the Compact Encoding of SINT, INT, DINT, LINT data 
values. A generic illustration of the encoding of SignedInteger values is given below: 
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Table C-5.3 SignedInteger Encoding 


Octet Number 
SINT 


INT 
DINT 


LINT 


The following example illustrates the encoding of a variable of type DINT whose value is 
12345678hex- 


Table C-5.4 Example Compact Encoding of a SignedInteger Value 


Octet Number 4th 


C-5.2.3 UnsignedInteger Encoding 


This section gives you examples of the Compact Encoding of USINT, UINT, UDINT, ULINT, 
and ENGUNIT data values. A generic illustration of the encoding of UnsignedInteger values is 
given below: 


Table C-5.5 UnsignedInteger Encoding 


Gciet Namiber 


The example below illustrates the encoding of a variable of type UDINT whose value is 
AABBCCDDhex. 


Table C-5.6 Example Compact Encoding of a UnsignedInteger Value 


Octet Number 4th 
unr [pp fcc [aa [AA 


C-5.2.4 FixedLengthReal Encoding 


This section gives you examples of the Compact Encoding of REAL and LREAL data values. 
A generic illustration of the encoding of FixedLengthReal values is given below: 


Table C-5.7 FixedLengthReal Encoding 


Octet Number | ist_| 2nd | 3rd_| 4th | Sth | 6th_| 7th | 8th 


REAL [OLSB_|iLsB_ [2LsB_|3LSB_ OT | | 
LREAL 6LSB__|7LSB 


The example below illustrates the encoding of a variable (Float1) whose type is REAL and 
whose value is Floatl: = 10.0. (The assignment of the value is using the IEC 1131-3 notation. 


The ASN.1 value is {’41200000’H} in IEEE format (1.25*23 , exponent is 130(bias 127), 
fraction is 25)). 
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C-5.2.5 


C-5.2.6 


Table C-5.8 Example Compact Encoding of a REAL Value 


Octet Contents aes 1LSB | 2LSB as 


REAL 00 20 


The example below illustrates the encoding of a variable (Float2) whose type is LREAL and 


whose value is Float2: = —100.0. ( {C059000000000000’H} in IEEE format (1.5625*26, 
exponent is 1029 (bias 1023), fraction is .5625)). 


Table C-5.9 Example Compact Encoding of a LREAL Value 


Octet Contents SLSB 7LSB 
LREAL CC Ce CC CO 


Time Encodings 


This section gives you examples of the Compact Encoding of TIME, DATE, TIME_OF_DAY, 
DATE_AND_TIME, FTIME, LTIME, ITIME data values. A generic illustration of the 
encoding of Time values are given below: 


Table C-5.10 Time Encoding 


OctetNumber_| ist_ | 2nd | 3rd | 4th | sth | 6th | 7th | 8th 


TIME a 
DATE fOLSB_ |iLsB_ | | 
TIME_OF_DAY 
Time Time Time Time a = 
FTIME 
LTIME Coe 7LSB 


String Encodings 


This section gives you examples of the Compact Encoding of STRING, STRING2, STRINGN, 
and SHORT_STRING data values. 


Important: The preferred string type for user supplied string data is STRING2 due to 
international character string requirements. 


A generic illustration of the encoding of a STRING value is given below: 
Table C-5.11 STRING Encoding 


Contents Contents 
(charcount) (string contents) 


STRING OLSB 1LSB 


1 byte character 


A generic illustration of the encoding of a STRING2 value is given below: 


Table C-5.12 STRING2 Encoding 


Contents Contents 
(charcount) (string2contents) 


STRING2 OLSB 1LSB OLSB 


2 byte character 
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A generic illustration of the encoding of a STRINGN value is given below: 


Table C-5.13 STRINGN Encoding 


Contents Contents Contents 
charsize charcount stringNcontents 


STRINGN 


N byte character 


A generic illustration of the encoding of aSHORT_STRING value is given below: 


Table C-5.14 SHORT_STRING Encoding 


Contents 
(charcount) 


OLSB 


Contents 
(short_string) 


SHORT_STRING OLSB 


1 byte character 


The example below illustrates the encoding of a string variable whose contents equal ”Mill”. 
Encoding examples of all string types are presented. Character coding is specified in ISO 
10646. The hexadecimal equivalent is: {’4D696C6C’H} for 8 bit encoding. 


The example below encodes ”Mill” as a STRING type. 
Table C-5.15 Example Compact Encoding of A String Value 
Contents Contents 
(charcount) (string contents) 
STRING joa fo Coc CC 
The example below encodes ”Mill” as a STRING2 type. 


Table C-5.16 Example Compact Encoding of String2 Value 
Contents Contents 
(charcount) (string2 contents) 
STRING2_|04 joo 4D [oo _|69 [oo [6c [oo [6c oo 


2 byte character 


The example below encodes ”Mill” as a SHORT_STRING type. 


Table C-5.17 Example Compact Encoding of SHORT_STRING Value 
Contents 


Contents 
(charcount) (short_string contents) 


jos am fos oc 


SHORT_STRING 
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C-5.2.7. _‘ FixedLengthBitString Encoding 


This section supplies examples of the Compact Encoding of BYTE, WORD, DWORD, 
LWORD data values. The table below illustrates the bit placement rules associated with the 
Compact Encoding of a FixedLengthBitString. 


Table C-5.18 Example Compact Encoding of a FixedLengthBitString Value 


Octet Number> 1st 2nd 3rd 4th 5th 6th 7th 8th 
BYTE TevciO 

WORD ee 0 USsseapes 8 

DWORD i oer, 0 Tose 8 i ree 16 OL sesnse 24 

LWORD 7 ose 0 TS icine 8 Zassesee 16 BS Lisasets 24 ais een 32 47 cssees! 40 55.....48 | 63......56 


The examples below illustrate the encoding of a BYTE, WORD, DWORD, and an LWORD. 


Figure C-5.1 Example Compact Encoding of A BYTE FixedLengthBitString 


Bits In Memory: 
Sala Eee 
00001111 
Compact Encoded BYTE 
00001111 or OFhex 


Figure C-5.2 Example Compact Encoding of A WORD FixedLengthBitString 


Bits In Memory: 


00001111 11001111 


Compact EncodedWORD 
11001111 00001111 orCHOFhex 


Figure C-5.3 Example Compact Encoding of A DWORD FixedLengthBitString 


Bits In Memory: 
a 31... 0 


00001111 11001111 10110110 00111110 


Compact Encoded DWORD 
00111110 10110110 11001111 00001111 or 3EB6CFOFhex 


Figure C-5.4 Example Compact Encoding of A LWORD FixedLengthBitString 
Bits In Memory: 
11110000 11001111 10110110 00111110 11110000 00101101 00011110 00001111 
Compact Encoded LWORD 
00001111 00011110 00101101 11110000 00111110 10110110 1100111111110000 or OFLE2DF03EB6CFFOhex 


C-5.2.8 Array Encoding 


The array encoding uses the encoding rules for the CIP Data types for each element and 
concatenates the elements which compose the array. The encoded values of the array elements 
are encoded in the same order as they are declared in the corresponding ASN.1 type or variable 
specification. These elements may be of any CIP Data type. 
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Array definitions follow FIP and FieldBus standards, whose committees are currently planning 
to specify the bounding limits for each dimension of an array. The ASN.1-style definition of a 
single—dimensional array in a CIP network is: 


ARRAY ::= SEQUENCE OF { array _dimension_low_bound, 
array dimension high bound, CIPData } 


Assume the following array definition:: 


ARRAY1 ::= SEQUENCE OF {array_dimension_low_bound := 0, 
array_dimension_high_bound := 1, UINT} 


Plugging the UINT values {1,2} into this array definition yields the following encoding: 


Table C-5.19 Example Compact Encoding of a Single Dimensional ARRAY 


Octet Number 
ARRAY 


The ASN.1-style definition of a two-dimensional array in a CIP network is: 


ARRAY ::= SEQUENCE OF { array_dimension_low_bound, 
array dimension_high bound, 

SEQUENCE OF { array _dimension_low_bound, 
array dimension high bound, CIPData } } 


The ASN.1-style definition of a three—dimensional array in a CIP network is: 


ARRAY ::= SEQUENCE OF { array_dimension_low_bound, 
array dimension _high bound, 
SEQUENCE OF { array _dimension_low_bound, 
array _dimension_high bound, 
SEQUENCE OF { array _dimension_low_ bound, 
array dimension high bound, CIPData } } } 


Since CJPData may comprise either ElementaryData or DerivedData, a new type or variable 
specification may be required before transmitting the values for the ARRAY. 


A multi-dimensional array is seen on the wire as a single—dimensional array. The order of the 
array elements is maintained via the packing/unpacking sequence followed by the end nodes. 
The sequence followed is to access the Nth dimension of the array for all values of the other 
dimensions. 


This is achieved by first accessing the array with all dimensions set to their initial index values. 
After this the Nth dimension is incremented through all of its index values. When the end of the 
index range for the Nth dimension is reached, the (N-1)th dimension is incremented, and the 
Nth dimension is set to its initial index value. This process is repeated until all of the array’s 
dimensions have reached the ends of their index ranges, and results in the array being packed 
into the message buffer as a single—dimensional array. The same procedure is followed to 
unpack the single—dimensional array into a multi—dimensional array. 
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The two-dimensional array shown results in the data stream below when it is packed into a 
single—dimensional array following the compact encoding rules: 


ARRAY] [0..1 , 0..2] of UINT := { { 1, 2, 3 },{ 4, 5, 6 } } 
Table C-5.20 Example Compact Encoding of a Multi-Dimensional ARRAY 


Past [na [ea [aah [a [ wae [em [ a [ oem [om [aie [em 
fa fo [efofsfofa[ mofo] ofa 


C-5.2.9 Structure Encoding 


Octet Number 
ARRAY 


The structure encoding uses the encoding rules for the CIPData types for each element and 
concatenates the elements which compose the structure. 


The encoded values of the structure elements are encoded in the same order as they are 
declared in the corresponding ASN.1 type or variable specification. These elements may be of 
any CIPData type. 


STRUCT ::= SEQUENCE OF CIPData —- May be different types 


Since CIPData may be comprised of either ElementaryData or DerivedData, a new type or 
variable specification may be required before transmitting the values for the STRUCT. 


Assume the following structure definition: 
newstruct ::= SEQUENCE { BOOL,UINT,DINT} 


Plugging the values {TRUE,’ 1234’H,’56789ABC’H} into the structure results in the following 
encoding: 


Table C-5.21 Example Compact Encoding of a STRUCTURE 
wom [of oe [foc | om | | 5 


C-5.2.10 Examples of How More Complex Data Formats are Encoded 


The examples below show how more complex data formats are packed. Example 1 shows the 
packing of an array of structures. Example 2 shows how a structure with an array element is 
packed. 


Example 1: Encoding an Array Of Structures: 


STRUCT1 ::= SEQUENCE OF { 
UINT elel; 
USINT ele2; 
USINT ele3; 
USINT ele4; 
UINT ele5 
} 
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ARRAY1 [ 0..1 , 0..2 ] of STRUCT1 := { 
{Tp 25. By ay 5 de M6. 7 Bie (99.120. }, 
{ 11, 12, 13, 14, 15 } }, 
{ { 15, 14, 13, 12, 11}, { 10, 9; 8, 7, 6 }, 
{ 5. 4-352, ib 44 


results in the following data stream: 


[01] 02] [03] [04] [05] [00] [06] [00] [07] [08] [09] [0A] [00] 
[0B] [00] [0C] [0D] [OE] [OF] [00] [OF] [00] [OE] [OD] [0c] [0B] [00] 
[OA] 09] [08] [07] [06] [00] [05] [00] [04] [03] [02] [01] [00] 


Example 2: Encoding a Structure with an Array Element 


STRUCT2 ::= SEQUENCE OF { 
UINT elel; 
ARRAY [ 0..2 ] of USINT array2; 
UINT ele5; 

STRUCT2 := { 1, { 2, 3, 4 }, 5 } 


results in the following data stream: 
[01] [00] [02] [03] [04] [05] [00] 
C-6 Data Type Reporting 
Objects may choose to implement a mechanism for reporting Data Type of a particular 


Attribute or transmitting type information along with the actual data. This section defines the 
means by which Data Typing information is conveyed. 


The specification of CIP Data Type information utilizes the ASN.1 methodology specified in 
ISO 8824:1987(E) and ISO 8825:1987(E) with CIP defined optimizations to encode the 
DataTypeSpecification production defined in section C-4.2. The CIP defined optimizations 
are listed below: 


e The Length Octet of a NULL type is not encoded. For example; the encoding of 
’abc [PRIVATE 1] IMPLICIT NULL’ would be: Cl1pex (a tag with no length octet). 


The sections that follow detail: 


e Elementary Data Type Reporting 
e Constructed Data Type Reporting 


C-6.1 Elementary Data Type Reporting 


Elementary data types are identified using the identification codes defined in the table below. 
These codes illustrate the encoding of the primitive members of the DataTypeSpecification 
production. Remember that CIP specifies that ASN.1 NULL types do not report the Length 
Octet of zero (0). 


Table C-6.1 Identification Codes and Descriptions of Elementary Data Types 


Data Type Data Type Data Type Description 
Name Code (in hex) 


BOOL Logical Boolean with values TRUE and FALSE 
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Data Type Data Type Description 
Name Code (in hex) 
SINT Signed 8-bit integer value 
INT Signed 16-bit integer value 
DINT Signed 32-bit integer value 
LINT Signed 64-bit integer value 
USINT Unsigned 8-bit integer value 
UINT Unsigned 16-bit integer value 
UDINT Unsigned 32-bit integer value 
ULINT Unsigned 64-bit integer value 
REAL 32-bit floating point value 
LREAL 64-bit floating point value 
STIME Synchronous time information 
DATE Date information 
TIME_OF_DAY Time of day 
DATE_AND_TIME Date and time of day 
STRING [Do character string (1 byte per character) 
BYTE bit string - 8-bits 
WORD bit string - 16-bits 
DWORD bit string - 32-bits 
LWORD bit string - 64-bits 
STRING2 character string (2 bytes per character) 
FTIME [D6 Duration (high resolution) 
LTIME Duration (long) 
ITIME [ps Duration (short) 
STRINGN [po character string (N bytes per character) 
SHORT_STRING character sting (1 byte per character, 1 byte length indicator) 
TIME [DB Duration (milliseconds) 
EPATH CIP path segments 
ENGUNIT [DD __—_| Engineering Units 
STRINGI International Character String 


C-6.2 Constructed Data Type Reporting 


This section details the means by which the structure and array information presented within 
the DataTypeSpecification production is represented. 


C-6.2.1 Structure Type Definition 
CIP defines two different methods for reporting Structure Type Definitions: 


e Formal Encoding (FormalStrucTypeSpec) 
e Abbreviated Encoding (AbbreviatedStrucTypeSpec) 


Formal encoding is used to provide a detailed report of the complete structure definition, 
including the complete definition of all component data types. Abbreviated encoding is used to 
specify a shorter form of the structure definition. This shorter form does not include the data 
types associated with the structure’s components. 
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Formal Encoding for Structure Type Information 


The two examples below illustrate formal encoding for structure type specifications. This is 
actually an example of the encoding of the FormalStrucTypeSpec production defined in 
section C-4.2, Data Type Specification/Dictionaries. 
Example 1: 
Table C-6.2 shows the encoding of the following structure definition 

STRUCT ::= SEQUENCE OF { BOOL, UINT, DINT } 


Table C-6.2 Example 1 of Formal Encoding of a Structure Type Specification 


Struc Type Length Component Component Component Types 
Type Types Types 
BOOL UINT DINT 
A2 03 C1 C7 C4 


Note that the IMPLICIT NULL types from the DataTypeSpecification production are not 
followed by a Length Octet of zero (0). 


Example 2: 
Table C-6.3 shows the encoding of the following structure definition 
STRUCT _MAIN ::= SEQUENCE OF { UINT, STRUCT_SUB, INT } 
with subelement STRUCT_SUB defined as: 

STRUCT_SUB ::= 


SEQUENCE OF { UINT, SINT, INT } 


Table C-6.3 Example 2 of Formal Encoding of a Structure Type Specification 


Component 


Nested Component 


Type Struct Type 
Struct | Length | UINT Type Length | UINT SINT INT INT 
A2 07 C7 A2 03 C7 C2 C3 C3 


Abbreviated Encoding for Structure Type Information 


The example below illustrates the abbreviated encoding for structure type specifications. This 
is actually an example of the encoding of the AbbreviatedStrucTypeSpec production defined 
in section C-4.2, Data Type Specification/Dictionaries. 


The UINT defined within the AbbreviatedStrucTypeSpec production is initialized with a 16 bit 
Cyclic Redundancy Check (CRC) value. This can be used by application logic to determine 
whether or not the format of the structure has changed. The byte stream used to produce the 
CRC is the actual formally encoded (FormalStrucTypeSpec) structure type specification. See 
Section C-7, CRC Generation Algorithms. 
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Example: 


Table C-6.4 shows the abbreviated encoding of the structure definition presented in the 
previous section: 


Table C-6.4 Example of Abbreviated Encoding of a Structure Type Specification 


Struc Type Length UINT Containing CRC 
AO 02 C7 26 


Note that the algorithms presented in section used to generate the CRC value of 26C7hex from 
the Formally Encoded type specification: [A2][07][C7][A2][03][C7][C2][C3][C3]. 

C-6.2.2. Array Type Definition 
CIP defines two different methods for reporting Array Type Definitions: 


e Formal Encoding (FormalArrayTypeSpec) 
e Abbreviated Encoding (AbbreviatedArrayTypeSpec) 


Formal encoding is used to provide a detailed report of the complete array definition, including 
the data content and the array’s dimensions. Abbreviated encoding is used to specify a shorter 
form of the array definition. This shorter form does not include information specifying the 
array’s dimensions. 


Formal Encoding for Array Type Information 

The two examples below illustrate formal encoding for structure type specifications. This is 

actually an example of the encoding of the FormalArrayTypeSpec production defined in 

section C-4.2, Data Type Specification/Dictionaries. 

Example 1: 

Table C-6.5 shows the formal encoding of the following array definition 

ARRAY 1 ::= SEQUENCE OF { array_dimension_low_bound := 0, 
array_dimension_high_bound := 9, 


UINT } 


Table C-6.5 Example 1 of Formal Encoding of An Array Type Specification 


Lower Lower Upper Upper 
Type Bound Bound Lower Bound Bound Upper 
Array Length Tag Length Bound Tag Length Bound UINT 


A3 07 C7 01 00 81 01 09 C7 


Note that the IMPLICIT NULL types from the DataTypeSpecification production are not 
followed by a Length Octet of zero (0). 
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Example 2: 
Table C-6.6 shows the encoding of the following array definition 


ARRAY 1 ::= SEQUENCE OF { array_dimension_low_bound := 0, 
array_dimension_high_bound := 19, 
SEQUENCE OF { array_dimension_low_bound := 0, 
array_dimension_high_bound := 255, STRUCT_ELE} 


in which STRUCT_ELE is defined as: 


STRUCT_ELE ::= SEQUENCE OF { UINT, SINT, INT } 


Table C-6.6 Example 2 of Formal Encoding of an Array Type Specification 
Formal Encoding: 


[A3] [13] [80] [01] [00] [81] [01] [13] [A3] [OB] [80] [01] [00] [81] [01] LFF] [A2] [03] [C7] [C2] [C3] 


Lower Lower Upper Upper 
Array Type Bound Bound Lower Bound Bound Upper 
Type Length Tag Length Bound Tag Length Bound 
A3 13 80 01 00 81 01 13 oes 
Array Contents 
Lower Lower Upper Upper 
Array Type Bound Bound Lower Bound Bound Upper 
Type Length Tag Length Bound Tag Length Bound 
wee | AB 0B 80 01 00 81 01 FF be 


Nested Array Contents 


Struct 


Type 
Type Length UINT SINT INT 
A2 03 C7 


Note that the IMPLICIT NULL types from the DataTypeSpecification production are 
not followed by a Length Octet of zero (0). 


Abbreviated Tag Encoding for Array Type Information 


The abbreviated encoding of an Array type DOES NOT include the information specifying the 
Array’s dimensions. This is actually an example of the encoding of the 
AbbreviatedArrayTypeSpec production defined in section C-4.2, Data Type 
Specification/Dictionaries. 
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Example 1: 

Table C-6.7 shows the abbreviated encoding of the following array definition: 

ARRAY2 ::= SEQUENCE OF { array_dimension_low_bound := 0, 
array_dimension_high_bound := 9, 


UINT } 


Table C-6.7 Example 1 of Abbreviated Encoding of an Array Type Specification 


Array 
Type Type Length UINT 
Al 01 C7 


Note that the IMPLICIT NULL types from the DataTypeSpecification production are not 
followed by a Length Octet of zero (0). 


Example 2: 
Table C-6.8 shows the abbreviated encoding of the following array definition: 


ARRAY ::= SEQUENCE OF { array_dimension_low_bound := 0, 
array_dimension_high_bound := 19, 
SEQUENCE OF { array_dimension_low_bound := 0, 
array_dimension_high_bound := 899, STRUCT_ELE } 
} 


in which STRUCT_ELE is defined as: 
STRUCT_ELE ::= SEQUENCE OF { UINT, SINT, INT } 
Table C-6.8 Example 2 of Abbreviated Encoding of an Array Type Specification 


Array Contents 


Nested Component 


Array Type Array Type Struct Type UINT Containing 
Type Length Type Length Type Length CRC 
Al | 06 Al 04 AO 02 59 51 


C-7 CRC Generation Algorithms 


The C routine below generates a CRC via the polynomial driven method. 


[BRR RRR KKK KK RK RRR RK KK RR RR RR RK KKK KK KK KK KK KK KKK 


Function Name: calcPolyCrc() 


Description: calculates a Cyclic Redundancy Checksum CRC) via the 
polynomial driven method. 


Inputs: start_addr - the address of the first byte which is involved 
in the cre calculation 


Size - the number of consecutive bytes that are involved in the 
cre calculation. Size of 0 is invalid. 


Outputs: a 16 bit value containing the calculated CRC 
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HR KR RR RR RR RR KKK KK KK KK KK KK / 


unsigned16BitInteger calcPolyCre(start_addr, size) 
unsigned8BitInteger *start_addr; 
unsigned32BitInteger size; 

{ 

unsigned1léBitInteger crc; 

unsigned8BitInteger carry; 

unsigned8BitInteger b; 

unsigned32BitInteger cnt; 


cre = 0; 
while (size) 
{ 
b = (unsigned8BitInteger) *start_addr++; 
CEG Ss bs 
cnt = 0; 
while (cnt < 8) 
{ 
carry = cre & 1; 
crc >>= 1; 
if (carry) 
{ 
ere “= 0xa001; 
cnt++; 
} 
} 
size--; 
} 
return (crc) ; 

} 

The C routine below generates a CRC via the table driven method. 
unsigned16BitInteger poly table[] = {0x0000, OxCocl, 0xC181, 
0x0140, OxC301, 0x03C0, 0x0280, OxC241, OxCé601, 
Ox06CO, 0x0780, OxC741, 0x0500, OxC5Cl1, 0OxC481, 
0x0440, OxCCOl, Ox0CCO, Ox0D80, OxCD41, OxOFOO, 
OxCFC1, OxCE81, Ox0E4O, OxO0AO0O, OxCACl1, OxCB81, 
Ox0B40, OxC901, Ox09CO, 0x0880, OxC841, OxD801, 
0x18CO0, 0x1980, OxD941, Ox1BO0O, OxDBC1, OxDA81, 
Ox1A40, Ox1E00, OxDEC1, OxDF81, Ox1F40, OxDDO1, 
Ox1DCO, Ox1C80, OxDC41, 0x1400, OxD4Cl1, OxD581, 
0x1540, OxD701, Ox17CO, 0x1680, OxD641, OxD201, 
Ox12C0, 0x1380, OxD341, 0x1100, OxD1Cl, OxDO081, 
0x1040, OxFOO1, 0Ox30CO, 0x3180, OxF141, 0x3300, 
OxF3C1, OxF281, 0x3240, 0x3600, OxF6C1, OxF781, 
0x3740, OxF501, 0x35CO, 0x3480, OxF441, 0x3C00, 
OxFCC1, OxFD81, 0Ox3D40, OxFFO1, Ox3FCO, Ox3E80, 
OxFE41, OxFAO1, Ox3ACO, Ox3B80, OxFB41, 0x3900, 
OxF9C1, OxF881, 0x3840, 0x2800, OxE8Cl, OxE981, 
0x2940, OxEBO1, Ox2BCO, Ox2A80, OxEA41, OxEEO1, 
Ox2ECO, Ox2F80, OxEF41, Ox2D00, OxEDC1, OxEC81, 
Ox2C40, OxE401, 0Ox24CO, 0x2580, OxE541, 0x2700, 
OxE7C1, OxE681, 0x2640, 0Ox2200, OxE2Cl1, OxE3 81, 
0x2340, OxE101, Ox21CO, 0x2080, OxE041, OxA001, 
Ox60CO, 0x6180, OxAl141, 0x6300, OxA3C1, OxA281, 
0x6240, Ox6600, OxA6C1, OxA781, 0x6740, OxA501, 
Ox65CO0, 
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0x6480, OxA441, Ox6Co0o, OxACC1, OxAD81, Ox6D40, 
OxAFO1, Ox6FCO, Oxé6E80, OxAE41, OxAAO1, Ox6ACO, 
Ox6B80, OxAB41, 0x6900, OxA9C1, OxA881, 0x6840, 
0x7800, OxB8Cl, OxB981, 0x7940, OxBBOl1, Ox7BCO, 
Ox7A80, OxBA41, OxBEO1, Ox7ECO, Ox7F80, OxBF41, 
0x7D00, OxBDCl1, OxBC81, 0x7C40, OxB401, 0x74CO, 
0x7580, OxB541, 0x7700, OxB7Cl1, OxBé681, 0x7640, 
0x7200, OxB2Cl1, OxB381, 0x7340, OxB101, O0x71C0, 
0x7080, OxBO41, 0x5000, Ox90C1, 0x9181, 0x5140, 
0x9301, 0x53C0, 0x5280, 0Ox9241, Ox9601, Ox56CO, 
0x5780, Ox9741, 0x5500, Ox95Cl1, 0x9481, 0x5440, 
Ox9COl, Ox5CCO, Ox5D80, Ox9D41, Ox5F00, Ox9FC1, 
Ox9E81, Ox5E40, Ox5A00, Ox9AC1, Ox9B81, Ox5B40, 
Ox9901, 0x59CO, 0x5880, 0x9841, Ox8ss0l, O0x48CO, 
0x4980, 0x8941, Ox4BO00, Ox8BCl, Ox8A81, Ox4A40, 
Ox4E00, Ox8ECl, Ox8F81, Ox4F40, Ox8sDO1, Ox4DCO, 
Ox4C80, Ox8C41, 0x4400, Ox84Cl, Ox8581, 0x4540, 
0x8701, 0x47CO, 0x4680, Ox8641, Ox8201, Ox42C0, 
0x4380, 0x8341, 0x4100, Ox81Cl, Ox8081, 

0x4040}; 

[BRR RR RR RK KK KK KK KKK RR RK KK RR RR RR RR RR KK KK KK KK KK KK 
FFunction Name: calcTableCrc () 

Description: Calculates a 16 bit cre value based on the input 


parameters via 

the table driven method 
Inputs: start_addr - pointer to the first byte of memory 
involved in the 

calculation of the CRC 

size - the number of bytes to include in the CRC 

generation 
Outputs: a 16 bit CRC 
HR KR RR RR RK KK KKK RR RR KK RR RR RR RK KK KK KK KKK / 
unsigned1i6éBitInteger calcTableCrc(start_addr, size) 
unsigned8BitInteger *start_addr; 
unsigned32BitInteger size; 
{ 
unsigned16BitInteger crc; 
unsigned16éBitInteger data; 


cre = 0; 
while (size) 
{ 


data = (unsignedi6éBitInteger) * start_addr++; 
ere = ((cre >> 8) * poly table[(cre * data) & 255]); 
size--; 


} 


return (crc) ; 
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Introduction 


In the physical sciences, quantities are measured by comparing them to a quantity whose 
magnitude is defined to be unity. Such a quantity is called a unit. For example, a commonly 
used unit for mass is the kilogram. 


Within the CIP specification, units are often used to describe a device’s interface to the 
physical world. For example, a photoelectric switch might use units of length to describe its 
min/max detect distances, and a position controller might use units of velocity and acceleration 
to describe its movements. 


This appendix defines a system of units for use in the CIP specification, including names, 
symbols, and a mechanism for reporting units. This system of units uses the commonly 
recognized name engineering units. 


Reporting Engineering Units (ENGUNIT Codes) 


An attribute of data type ENGUNIT is used to specify the engineering units for one or more 
other attributes. 


By providing a ENGUNIT attribute, an object can manage different engineering units. For 
example, an analog sensor object with a ENGUNIT attribute could potentially measure 
temperature, flow, pressure, and so on. 


If the engineering unit used by an object does not vary, the unit can be specified in the object’s 
specification, and a ENGUNIT attribute is not needed. In such cases, names and symbols of 
units listed in the object’s specification should remain consistent with this appendix. 


The ENGUNIT code is used to represent engineering units only, and does not imply a specific 
data type, range, or scaling. For example, if the engineering units of a UINT (16-bit unsigned 
integer) attribute is defined by another ENGUNIT attribute which indicates milliamps, this 
does not imply a range of 0-65535 mA. The encoding of a given unit by an object is defined 
entirely by that object’s specification. 


The ENGUNIT data type is encoded as a UINT (16-bit unsigned integer). The most significant 
byte of this UINT selects a group of similar units, and the least significant byte selects a 
specific unit within that group. 
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D-1.2 


Groups of Engineering Units 


The following groups of engineering units are listed in the tables of section D-2: 


Value of MSB 
00 hex thru 07 hex 
08 hex thru OF hex 

10 hex 
11 hex 
12 hex 
13 hex 
14 hex 
15 hex 
16 hex 
17 hex 
18 hex 
19 hex 
1A hex 
1B hex 
1C hex 
1D hex 
1E hex 
1F hex 
20 hex 
21 hex 
22 hex 
23 hex 
24 hex 
25 hex 
26 hex 
27 hex 
28 hex 
29 hex 
2A hex 
2B hex 
2C hex 
2D hex 
2E hex 
2F hex 
30-FF hex 


Engineering Units Group 
Reserved 
Vendor specific enumerations 
General 
Time (includes Date) 
Temperature 
Pressure 
Flow 
Acceleration 
Amount of Substance 
Angle 
Area 
Capacitance 
Charge (Electric Charge) 
Conductance (Electric Conductance) 
Current (Electric Current) 
Energy (Heat, Work) 
Force 
Frequency (includes RPM) 
Inductance 
Inertia 
Length (Distance, Displacement) 
Light (Luminous Intensity) 
Magnetic Flux 
Mass 
Power (Wattage) 
Radiology 
Resistance (Electric Resistance) 
Sound 
Torque (Moment of Force) 
Velocity (Speed) 
Viscosity 
Voltage 
Volume 
Density 


reserved for future standardization 
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D-1.3 Naming Conventions 


In the tables of section D-2, each unit lists: 


e Value: Value used to represent the unit ina ENGUNIT attribute 

e Name: Commonly used name for the unit (often used for text or display) 

e Symbol: Commonly used symbol for the unit (often used for expressions) 

e Base Units: Expression in terms of other base units (such as metric conversions) 


Many of the names, symbols, and expressions are taken from the International System of Units 
(SI). * 
In addition, the following conventions are taken from SI specifications: 


e The following SI prefixes are used for names and symbols in order to form decimal 
multiples and submultiples of units as appropriate: 


18 M 
10° deka (or deca) da 


e Unit symbols and unit names are not used together. For example, millivolt and mV are 
valid, but mvolt and milliV are not valid. 

e A name (symbol) prefix is inseparable from its unit name (symbol). For example, milli 
amp and milli-amp are not valid names. 

e Acentered dot (‘e’) is used to indicate multiplication, and a solidus (‘/’) is used to indicate 
division. 

e Each unit definition is listed in its singular form. For example, velocity is listed as meter 
per second, not meters per second. Plural forms are more commonly used in values for a 
given unit (such as 8 meters per second). 

e Capitalization follows SI conventions. 


Also, in order to offset footnote markers from other superscripts, each footnote marker is 
preceded by the # symbol. 


' The International System of Units (SI), NIST Special Publication 330, United States Department of Commerce, Tech- 
nology Administration, National Institute of Standards and Technology. See also: Guide for the Use of the Inter- 
national System of Units (SI), NIST Special Publication 811. These documents may be available for access on 
ww.nist. gov. 
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D-2 Tables 


D-2.1 Profile Specific Engineering Unit Enumerations 


Base Units 


0000 hex through 07FF hex Reserved to prevent overlap with the SEMI Standard 


D-2.2 Vendor Specific Engineering Unit Enumerations 


Base Units 


0800 hex through OFFF hex This range of values is reserved for Engineering Units specific to a particular vendor’s 
needs. Any device that utilizes values within this range must enumerate (or otherwise 
identify) the exact meaning of each value that can be represented. These values are 
reserved for previously un-enumerated Engineering Units. Engineering units that are 
already represented by enumer-ations in the following sections are not allowed to be 


assigned in this vendor specific range. 


D-2.3 General 
Value Name Symbol Base Units 


1005 hex bit Po 


_D-6— 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


Volume 1: Common Industrial Protocol Specification, Appendix D: Engineering Units 


D-2.4 Time (includes Date) 


1100 hex second * 


D-2.5 Temperature 


1200 hex degree Celcius * K - 273.15 

1201 hex degree Fahrenheit (K e 1.8) — 459.67 

1202 hex kelvin * 

1203 hex Degree Rankine zz aa Ke18 

1204 hex decidegree Celcius °C/10 (K @ 10) - 27.315 

1205 hex decidegree Fahrenheit °F/10 (K @ 1.8 © 10°) - 45.967 

1206 hex decikelvin K/10 Ke107 

1207 hex decidegree Rankine °R/10 Ke18e10" 
1208-12FF hex reserved for future standardization 


* The second is an SI base unit, defined as the duration of 9192631770 periods of the radiation corresponding to the 
transition between the two hyperfine levels of the ground state of the cesium-133 atom. 

> When the millisecond unit is encoded with INT data type, it is equivalent to the ITIME data type defined in Appendix 
C. When the millisecond unit is encoded with DINT data type, it is equivalent to the TIME data type defined in 
Appendix C. 

“When the microsecond unit is encoded with DINT data type, it is equivalent to the FTIME data type defined in 
Appendix C. When the microsecond unit is encoded with LINT data type, it is equivalent to the LTIME data type 
defined in Appendix C. 

° The DATE unit and its symbol refer to the CIP DATE data type defined in Appendix C. 

5 The TIME _OF_DAY unit and its symbol refer to the CIP TIME_OF_DAY data type defined in Appendix C. 

7 The DATE _AND_TIME unit and its symbol refer to the CIP DATE_AND_TIME data type defined in Appendix C. 
® Although the correct SI name is degree Celcius, this unit is often named degree centigrade. 

° The kelvin is an SI base unit, defined as the fraction 1/273.16 of the thermodynamic temperature of the triple point of 
water. 
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D-2.6 


D-2.7 


Pressure 


Value 
1300 hex 
1301 hex 
1302 hex 
1303 hex 
1304 hex 
1305 hex 
1306 hex 
1307 hex 
1308 hex 
1309 hex 
130A hex 
130B hex 
130C hex 
130D hex 

130E-13FF hex 


Flow 
Value 
1400 hex 
1401 hex 
1402 hex 
1403 hex 
1404 hex 
1405 hex 
1406 hex 
1407 hex 
1408 hex 
1409 hex 
140A hex 
140B hex 
140C hex 
140D hex 
140E hex 
140F hex 
1410 hex 
1411 hex 
1412 hex 
1413 hex 
1414 hex 
1415-14FF hex 


Symbol 
pound-force per square inch (psi) | psi 


Base Units 
6.894757 © 10° Pa 
(101325/760) « Pa 


cnii0 G0) 
ee 
[sewed ortonresentaauon 


[pond persecone dT Sd 
[pond perminwe it id 
[ponderous id 
[resend for fowresandadavon |__| 


_D-8 — 
Edition 3.3 
ODVA & ControlNet International, Ltd. 


3.38638 ¢ 10° e Pa 


10° © Pa 
10° e Pa 
miekges? 
10? © Pa 
101325 e Pa 
9.80665 10’ e Pa 


Base Units 


ft/min 


10° ¢ m/s 
10° e m/s 
gal/s 
gal/min 
gal/hr 
lb/s 
lb/min 
Ib/h 
10° e g/min 
g/min 
0? ¢ g/hr 
10° e m?/min 
10° e m*/hr 
10° ¢ m?/min 
10° e m*/hr 
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D-2.8 Acceleration 


D-2.9 Amount of Substance 


D-2.10 Angle 


imoahex [ermine i) 
1705 ex a} 


D-2.11 Area 


ae 
a J 
Poe ad 


1807-18FF hex reserved for future standardization 


‘© The mole is an SI base unit, defined as the amount of substance of a system which contains as many elementary 
entities as there are atoms in 0.012 kilogram of carbon 12. When the mole is used, the elementary entities must be 
specified and may be atoms, molecules, ions, electrons, other particles, or specified groups of such particles. 

"' The radian is defined as the plane angle between two radii of a circle that cuts off on the circumference an arc equal 
in length to the radius. 

'? The steradian is defined as the solid angle that, having its vertex in the center of a sphere, cuts off an area of the 
surface of the sphere equal to that of a square with sides of length equal to the radius of the sphere. 
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D-2.12 Capacitance 


D-2.13 Charge (Electric Charge) 


D-2.14 Conductance (Electric Conductance) 
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D-2.15 Current (Electric Current) 


Symbol 


D-2.16 Energy (Heat, Work) 


1DOD hex specific energy mes” 
el 


1D11-1DFF hex reserved for future standardization 


'S The ampere is an SI base unit, defined as the constant current which, if maintained in two straight parallel conductors 
of infinite length, of negligible circular cross section, and placed 1 meter apart in vacuum, would produce between 
these conductors a force equal to 2 X 10°’ newton per meter of length. 

'’ The electronvolt is a unit which is accepted for use with SI units. However, the accepted value for 1eV has been 
experimentally obtained and the base units shown does not represent an exact value. 
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D-2.17 


D-2.18 


Force 
Value 
1E00 hex 
1E01 hex 
1E02 hex 
1E03 hex 
1E04 hex 
1E05-1EFF hex 


Frequency (includes RPM) 


Value 
1F00 hex 
1F01 hex 
1F02 hex 
1F03 hex 
1F04 hex 
1F05 hex 
1F06 hex 
1F07 hex 
1F08 hex 
1F09 hex 
1FOA hex 
1FOB hex 
1FOC hex 
1FOD hex 
1FOE hex 
1FOF hex 
1F10 hex 
1F11 hex 

1F12-1FFF hex 


Name 
newton 
surface tension 


[mane esas — | — 


#15 


Base Units 
mekges™ 
kges” 
9.80665 e N 
4.448 e N 
0.278 e N 


Base Units 
gs 
10° es! 
10° es! 
10° es! 
sg 
10° es! 
10° st 
s'/60 
s'/ 3600 
s'/ 86400 
bit/s 
kbit/s 
Mbit/s 


1.047198 ¢ 10° e rad/s 


'S For the purposes of this appendix, Frequency is defined as rate of occurrence (for a specified event). 


'® Usage of the symbols Bd and bd is also acceptable. 
'” Usage of the symbols RPS and r/s is also acceptable. 
'8 Usage of the symbols RPM and r/min is also acceptable. 
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D-2.19 Inductance 


D-2.20 Inertia 


D-2.21 Length (Distance, Displacement) 


'® The meter is an SI base unit, defined as the length of the path traveled by light in vacuum during a time interval of 
1/299792458 second. 

°° when using the symbol for nautical mile (nm), care should be taken to avoid confusion with the symbol for 
nanometer. 
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D-2.22 Light (Luminous Intensity) 


D-2.23 Magnetic Flux 


2401 hex magnetic flux density (tesla) kges?eAt 


2402 hex magnetic field (oersted) 79.57747 @ A/m 
2403-24FF hex reserved for future standardization 


D-2.24 Mass 


21 The candela is an SI base unit, defined as the luminous intensity, in a given direction, of a source that emits 
monchro-matic radiation of frequency 540 X 10” hertz and that has a radiant intensity in that direction of (1/683) watt 
per steradian. 

~ The kilogram is an SI base unit, defined as the mass of the international prototype of the kilogram. 
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D-2.25 Power (Wattage) 


ioe 


10> e W 
10° e W 


260F-26FF hex reserved for future standardization 


D-2.26 Radiology 


a 


*? When there is risk of confusion with the symbol for the radian, rd may be used as the symbol for rad. 
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D-2.27 
Value 
2800 hex 
2801 hex 
2802 hex 
2803 hex 
2804 hex 
2805 hex 
2806 hex 
2807 hex 
2808 hex 
2809 hex 
280A-28FF hex 


Sound 
Value 

2900 hex 
2901 hex 
2902 hex 
2903 hex 
2904 hex 
2905 hex 
2906 hex 
2907 hex 

2908-29FF hex 


D-2.28 


D-2.29 
Value 
2A00 hex 
2A01 hex 
2A02 hex 
2A03 hex 
2A04 hex 
2A05 hex 
2A06 hex 
2A07 hex 
2A08 hex 
2A09-2AFF hex 


Resistance (Electric Resistance) 


ee 
ee 


ee 
[saved or re senaaion—[ 


CdS 
[ eecbet 
1 
[ewved for fuwesndaavon [| 


Torque (Moment of Force) 


Name «Sm | 
torque (moment of force) | Nem | 


reserved for future standardization 


Base Units 
m’ekges*eA~ 
107eQ 
10°eQ 
10° eQ 
107% 06Q 
10° eQ 
107° Q 
10°eQ 
10°°Q 
10°eQem 


Base Units 


101¢B 


see #24 


see #25 


see #26 


see #27 


Base Units 


mekges? 


10’eNem 
9.80665 e Nem 
7.0615 °10°eNem 
1.1298 e10'e Nem 


*4 Sound Intensity Level is 10eloge( I/I, ), where I, = 10°? W/m’ in air and 6.66 107°? W/m’ in water. 
°° Sound Pressure Level is 20eloge( P/P, ), where P, = 20 p:Pa in air and 1 p:Pa in water. 
°° Voltage Level re 1mW across 600Q is 20eloge( V/.775 ), when the reference impedance is 6002. 
*7 Voltage Level re 1 V is 20eloge( V/1 ), where the impedance ratio is generally ignored. 
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D-2.30 Velocity (Speed) *”° 


D-2.31 Viscosity 


D-2.32 Voltage 


2D09 hex Vim mekges?eA? 


°8 For the purposes of this appendix, Velocity uses the traditional definition of distance over time, and thus units for baud rate and 
rpm are listed in the Frequency group. 
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D-2.33 Volume 


D-2.34 Density 


pt 
iain [| 
3 
3 
3 


2F06 hex British thermal unit per cubic foot 3.725895 ¢ 10 J/m? 


2F13-2FFF hex reserved for future standardization a 


*° The letter L was adopted by the General Conference on Weights and Measures (CGPM) in order to avoid the risk of confusion 
between the letter | and the numeral 1. Both the letter | and the letter L are internationally accepted symbols for the liter. According 
to Interpretation of the SI for the United States and Metric Conversion Policy for Federal Agencies (National Institute for Standards 
and Technology Pub 814), to avoid this risk, the symbol to be used in the United States is the letter L. 
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